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WELCOME 
to The MagPı 90 


y now you will have noticed the free gift on the print edition 
B of The MagPi. You may be wondering how useful a single strip of 
plastic can be? Very, very useful as it happens. 

You see, back in issue 88, Gareth Halfacree tested a Raspberry Pi 4 
with all the different firmware updates. This gave us an insight into just 
how important firmware was to the Raspberry Pi. But another thing 
came to light: Raspberry Pi 4 runs cooler when stood vertically. 

Alex Bate, Raspberry Pi’s digital content manager, got to work on a 
design that’s now attached to the front cover. All is explained on page 6. 

Do yourself a favour and unstick the Raspberry Pi 4 stand, then pop 
your Raspberry Pi 4 on its side and keep it vertical. 

It turns out that keeping Raspberry Pi 4 cool enables it to run at full 
speed for longer and, crucially, this opens up a world of overclocking, 
where you try to squeeze ever more performance out of a Raspberry Pi. 
Our overclocking tutorial (page 34) 
explains all. 

Raspberry Pi 4 has always been cool 
to us. But cool is fast in the world of 
computing, and this month we’re all 
about running Raspberry Pi as fast 
as possible. 
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Lucy 
Hattersley 


Lucy is editor of 
The MagPi. This 
month she did 
Veganuary and dry 
January. She'll see 
you at the bar in 
February. 
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Heat is the enemy of computer efficiency, which is why a stand to keep 
Raspberry Pi 4 cool is a big deal. Rosie Hattersley meets its maker 


here’s a curious piece of plastic proudly 
affixed to the front cover of this month’s 
print edition of The MagPi magazine. The 
Raspberry Pi 4 Stand is an exclusively designed 
holder that does wonders for your computer’s 
efficiency. The stand holds up to three Raspberry 
Pi 4 computers at once, and has been met with 
open arms by overclocking maestros. 
Issue 88 of The MagPi magazine included a 
thermal testing feature conclusively showing 
that running a Raspberry Pi 4 on its side enables 
it to run cooler, and therefore at full speed, 
for longer. 
To try out this principle for yourself, turn to 
this issue’s overclocking tutorial on page 34. 
If you’re reading the digital version of this 
article, you’ ll be able to get your hands on 
your own Raspberry Pi 4 Stand. We’re making 
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the files available for you to 3D-print or laser- 
cut your stand: find them on our GitHub page 
at magpi.cc/github. 


Making a stand 
Alex Bate is Raspberry Pi’s digital content 
manager and the stand’s inventor. “We were 
keen to design a system for securing Raspberry 
Pi on its side, allowing for greater airflow around 
the device,” she tells us. This increased airflow 
leads to improved cooling efficiency, which 
enables Raspberry Pi 4 to run optimally and 
makes it more receptive to overclocking. 
“The original idea was the design itself,” says 
Alex. “It’s so simple that you could cut slots 
in a piece of cardboard and recreate the stand 
at home. We wanted to make the system as 
accessible as possible, [so offering it as a gift 
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A For optimal performance, place your 
Raspberry Pi 4 upright in the stand 


m You'll be surprised how cool 
your Raspberry Pi 4 runs @ 


with] the magazine was the obvious choice. The 
idea of a gift, and the idea of having something 
this simple to recreate came hand in hand.” 

This, in turn, led to the idea of making ita 
one-piece stand that was easy to cover-mount on 
the magazine, and easy for readers to reproduce 


with a 3D printer. 
Ethernet (PoE) pins on one side of Raspberry a een 

Made to measure Pi 4. “I was keen on making it as fool-proof as An 
Alex began playing around with lengths and possible,” explains Alex, “and adding the PoE 
taking a lot of measurements of numerous silhouette, I feel, makes it pretty obvious how 
Raspberry Pi 4 boards to determine the correct you should use it.” 
width for the slots (silicon can vary by a fraction Alex says if you place a single Raspberry Piin 
of amillimetre). Eventually, the final design the middle slot, you'll be surprised how cool 
came to life. your Raspberry Pi 4 runs. You can also build a 

The stand has small indentations on one small cluster with three perfectly cool Raspberry 
side, which guide around the four Power over Pi boards. H 
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A shiny music box with a clear door for a screen proves an ideal 
upcycling candidate for an eighties tech fan keen to keep tabs 
on the weather. Rosie Hattersley hears more 


artin Mander is no stranger to The Walkman, of course, fits that description 
Martin repurposing outdated tech. “I started to a tee. Sony alone sold 200 million, while other 
Mander converting and upcycling vintage brands of cassette player were also legion. 
technology about ten years ago, after a brief stint 
Martin worksin blogging for Wired’s GeekDad column,” he tells | immedi ately fell in love 
the Intelligence us. Discovering he enjoyed documenting projects . . 
EE as much as building them, he began specialising in with it... It had a great 
EE giving new purpose to broken old tech - “especially 
Council. He's items I remember being ‘the latest thing’ during retro | 00 k 
passionate about the 1970s and 1980s when I was a child.” 
A Se Martin became enamoured of all things Press play 
life, especially Raspberry Pi-flavoured in 2014. Looking foraone- ` Martin's chance to ‘rescue’ one came when his 
projects involving box alternative to a PC for converted gadgets, he mother-in-law sent him a broken old Hitachi 
Raspberry Pi. was tipped off by a reader that Raspberry Pi might player that she found during a clear-out. 
work. He duly made a Raspberry Pi-powered VCR. “I immediately fell in love with it,” Martin 
Numerous ‘fruitful’ projects followed. There's now recalls. “It had a great retro look that drew me in”. 
a sizeable archive at magpi.cc/oldtechprojects. On closer examination he realised the window in 
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At the first sign of rain, 
WeatherMan's headphones 
begin to jiggle 


The more likely it is to rain, 
the more lights are Lit on 
the LED matrix, which also 
shows the temperature 
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ANTI - ROLLING 


Sugru mouldable glue 
offered lots of control 
when refashioning the 
cassette player's case 


and new components MADE IN JAPAN . | 
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Martin's first tech 
encounter was 
with a BBC Micro 
at school 


He half expected 
singers to appear 
if music cassettes 
were used with it 


Martin's home 
has 25 Raspberry 
Pi devices for 
both security and 
entertainment 
duties 


He has a ‘lovely 
but trashed’ 
1960s Dansette 
radio ripe for 
conversion... 


Key attraction: 

it perfectly 
matches the 
colour scheme in 
his bathroom 


m I'd been looking for a small case to hold a 


weather display for my desk for a while 
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WeatherMan 


the cassette player's door was - to the millimetre 
- the same size as a Raspberry Pi HAT. "At that 
point, all my other projects hit the back burner," 
he says. 

*T'd been looking for a small case to hold a 
weather display for my desk for a while, and this 
was the perfect thing. I also had an unused Unicorn 
HAT HD lying around and this seemed like the ideal 
project for it." To this he added servos and an awful 
lot of Sugru - a sort of malleable glue. 


. The early 1980s-style 
ambient loT weather 
display has a current 
conditions animation 


“In the past I’ve used Lego and Meccano to put 
things together, but with space being so tight in 
the case, I used Sugru this time around. It’s very 
workable but sets hard like plastic, perfect for 
fixing components in the right place.” 

The WeatherMan currently relies on API data 
from the Dark Sky weather service, but Martin 
eventually hopes to link it up to a Raspberry Pi 
weather station. “With a Raspberry Pi at each 
end, it should hopefully be straightforward!” he 
says optimistically. 


Getting the details right 

The main aim for what became the WeatherMan 
project was to keep the exterior as true as possible 
to the original. He wanted it to look like an 
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Make your own WeatherMan 


Dismantle the cassette player to create as 
much space as you can inside. Retain any 
parts you want to reuse. You may need to trim down 
the case inside to make the components fit nicely. 


A Helpfully, a Raspberry Pi 
99 Servo Unicorn HAT is precisely 
the same size as the 
cassette player's 
display window 


제 Diagram showing the 
relatively simple setup 
involved in creating the 
WeatherMan project 


B Raspberry Pi Zero You may need new bolts or a tiny magnet to 


make the cassette tape door close properly 
once you've tinkered inside. When you're satisfied 
that it works well, hot-glue the cassette player 
case and door. 


Dark Sky API 


The easiest. most advanced, weather API on the web, 
ornamental piece sitting on his desk speaker, 
hiding a useful IoT (Internet of Things) device until Ka 
it bursts into life. 
Martin thought the tape player seemed a bit 
naked without the iconic eighties headphones, Easy to Use Weather Conditions Advanced Data 
so he looked for ways to incorporate them into @ E 
the build. He drilled out the original jack plug and g 
fittings and joined them together using a 2mm 
threaded rod. With a small nut on each end of 

the rod and a servo connector at the bottom, the 
headphones now respond whenever the weather 

is about to change. Their servo-controlled jiggling 
always makes Martin smile, even if it’s to alert him 
rain is on the way. Hl 


= 


Use Raspbian Buster and adapted Python 
scripts to retrieve weather data from Dark 
Sky, display info on the Unicorn HAT, and (optionally) 
jiggle the headphones. Scripts and a ReadMe are on 
GitHub at magpi.cc/ghweatherman. 
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The animated robot is a 
digitised version of a felt model 
and tells event-goers about 
Dane and Nicole's projects 


BLIEP BLOOP! 


They have upcycled 
an old photo frame for 
an attractive surround 
for the touchscreen 


12 


Dane 
& Nicole 


Two makers 

that create 
tremendously 
terrible tech, which 
they happily share 
with you on their 
YouTube channel 
called '8 Bits and 
a Byte. 


When the screen 

is touched, the 
robot responds with 
various phrases and 
random movements 
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The Event Assistant 


The touchscreen is used 

in portrait mode, with the 
images rotated in Raspberry 
Pi's landscape mode 


E 


This amicable automated assistant was designed to help its makers 
explain their projects at tech events. Nicola King investigates 


hile Brussels-based makers Dane and 

Nicole enjoy meeting people, they 

find that endlessly repeating the 
stories behind their projects at events can be 
exhausting. “We presented our tech projects at a 
number of events in the past year, and we noticed 
we kept repeating ourselves throughout the day, 
giving the same talks and same explanations over 
and over again to the people visiting our booth," 


E A VIRTUAL ROBOT 
ASSISTANT. 


DARVA: The Event Assistant 


explains Nicole. “Whilst it's definitely fun to talk 
to so many people, it's also very tiring and so we 
thought it would be great to create an assistant, of 
sorts, to do this repetitive work for us.” 


Felt fusion 
Enter DARVA, a cute little animated robot who just 
loves to chat, and who runs off a Raspberry Pi 4. 
Dane says, “DARVA was made by first cutting and 
sewing all the separate parts of the robot out of 
felt. Then we took a picture of all these robot parts 
and cut them out using photo editing software [...]. 
To bring DARVA to life, we created a webpage (with 
HTML canvas and JavaScript) to which we added all 
these photographs and animated them.” 
Over the period of a week or two, Dane and 
Nicole's idea really took shape. The most 
difficult part of the project was the touchscreen 
orientation: “As the felt robot is standing upright, 
we thought it would be best to use the screen 
in portrait mode,” says Nicole. “Whilst you can 
easily change the screen rotation on Raspberry 


The robot's sewn felt pieces 
were photographed and then 
used to create animations 


Pi, the touchscreen still worked in landscape 
mode; the mapping between where you touched 
the screen and where you clicked was wrong.” 
After a lot of trial and error, they decided to keep 
Raspberry Pi running in landscape and just rotated 
all the animations. 


They have worked hard to 
ensure that DARVA has a 
lifelike quality 


Digital deputy 

They have also worked hard to ensure that DARVA 
has a lifelike quality, and introduced a degree of 
randomness to the robot’s actions. “The gauge 
rotates to arandom position, for example, and 

the eyes randomly look left or right for a random 
amount of time,” says Nicole. DARVA also loops 
through a series of texts that Dane and Nicole 
have written to give some more information about 
their booth at events, while some animations 

are activated by clicking or touching parts of the 
screen, including DARVA’s head and belly. 

So, how have people reacted to their new digital 
sidekick? Dane tells us there was some initial 
confusion at one event: “We placed the original felt 
version of DARVA next to the touchscreen, because 
we thought it would be interesting to show how we 
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went from a felt robot to a digital one. However, 
a lot of people thought the felt robot and the 
touchscreen were somehow connected and could 
interact, which was confusing because moving or 
touching the felt didn’t do anything.” However, 
DARVA has received a lot of compliments: “Kids 
especially loved the look and feel of it.” 

Dane and Nicole are considering developing 
the project further. “Maybe we can make it a 
video game, or an interactive story, or connect 
the felt robot to the digital robot as many people 
expected,” says Nicole. “We have so many ideas, 
we hardly know what we eventually will end up 
making, but one thing is for sure: it will involve a 
Raspberry Pi!” 


DARVA: The Event Assistant 
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The project took 
about 20 hours 
to complete 


Sewing the felt 
parts was the most 
time-consuming 
element 


Felt is a quick 

and cheap way to 
create in a range of 
shapes/colours 


The animations are 
run in Chromium 


DARVA is an 
acronym of 
‘Digitized Analog 
Robot Virtual 
Assistant’ 


The process of 
animation begins, 
after the pieces 
are cut out digitally 
using photo 
editing software 
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Heart-rate monitor 


When tasked with a developing a project during their Raspberry Pi classes, 
these students took the healthy option, as David Crookes explains 


Jon Witts is a 
certified Raspberry 
Pi certified educator 
and the director of 
digital strategy at 
Queen Margaret's 
School in York, 
where he teaches 
the Computer 
Science courses. 


@QM_CompSci 


ur hearts often feel like they’re skipping 

a beat when we see the latest ingenious 

projects from the ever-talented Raspberry 
Pi community. With this project, however, we 
could go as far as viewing the actual effects they 
have on our ticker, since a trio of students at 
Queen Margaret's School in York have worked on 
a heart-rate monitor using pHATs from Pimoroni 
and a pulse sensor. 


A With the pulse sensor attached 
to a finger, the heart's beats- 
per-minute can be read 


The students originally wanted 


to make a heart-monitoring 
watch but decided, due to the 
size of the Raspberry Pi Zero, to 
create a holdable device instead 
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Elena Lardies Lopez, Harriette Pemberton, and 
Myrtle Morley created the device as part of their 
computing lessons. “The school teaches a unit 
called ‘Physical Computing with the Raspberry Pi 
module and the students learn about connecting 
electronic devices [and controlling them from] 

a Raspberry Pi computer before forming small 
groups and deciding on a physical project,” 
explains Jon Witts, the school’s director of 
digital strategy. 


Revised plans 

After deciding on their initial aims - to create a 
watch that could track and display the wearer’s 
step count and heart rate - the students began 

to plan. They had to break down the problem and 
research how they could make their project: from 
the programming involved, to how it would be 
physically developed, and the hardware that would 
be needed. 


The beats-per-minute 
can be shown on the 
Pimoroni Scroll pHAT HD 


The environmental sensing board Enviro 
pHAT was able to collect data from the 
plug-and-play Pulse Sensor Amped 


“When the students saw the size of the 
Raspberry Pi Zero they would be using and the 
size of the pHATs involved, they quickly ruled out 
having the device as a watch,” Jon says. “Instead, 
the group focused on how they could combine two 
pHATS (the Enviro pHAT and the Scroll pHAT HD) 
to record data from an analogue pulse sensor and 
accelerometer data from the on-board sensors of 
the Enviro pHAT. The Scroll pHAT HD would be 
used to display the data recorded.” 


m The students learn about 
connecting electronic 
devices and controlling 
them from a Raspberry Pi @ 


Jon says the pulse sensor - which fits over the 
forefinger and allows heartbeats to be measured - 
uses a simple three-resistor voltage divider to drop 
its output voltage to 3V. This is then fed into one of 
the analogue pins on the Enviro pHAT. 


Stepping up 

As for the steps counter, the accelerometer data is 
taken from the Enviro pHAT's on-board sensors. 
*These two data sources are then read into the 
students’ Python program and they're displayed 
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제 Elena Lardies Lopez, 


Harriette Pemberton, 
and Myrtle Morley 
showcase their 

class project in 

a PowerPoint 
presentation 


Two of the main 
components in this 
simple build that was 
used to help students 
learn more about 
connecting and 
controlling devices 
with Raspberry Pi 


N 


across the LEDs of the Scroll pHAT HD,” Jon adds. 
He says the design makes use of the fact that 
both the Enviro pHAT and Scroll pHAT HD are PC 
devices with different registers for each pHAT. 
“The students used a header with extra-long pins 
to solder to the Enviro pHAT; this meant that the 
Scroll pHAT HD could then be ‘stacked’ on top of 
the Enviro pHAT, effectively chaining up multiple 
PC devices.” 

Given more time, Jon thinks the students could 
strive for greater accuracy: “The project could look 
at how to take the raw data from the accelerometer 
and accurately count steps with it, and also how to 
convert the high and low voltages recorded from the 
pulse sensor into a count of heartbeats per minute.” 

But it has taught valuable lessons in project 
originality and creativity along with teamwork, 
problem-solving, and presentation skills. “Running 
this unit has proven that the Raspberry Pi is a great 
device for teaching physical computing and the 
students take to it with enthusiasm,” Jon says. M 


Quick FACTS 


> ARaspberry Pi 
Zero is at its heart 


> The project cost 
less than £100 


> It displays toa 
Scroll pHAT HD 


» The students 
made use 
of Python 


» Enviro pHAT 
measures 
tri-axis motion 
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Audio radar 


Making radar technology accessible to students with help from Raspberry Pi 


Dewan 
Pieterse 


An electronics 
engineer whose 
mechatronic 
engineering project 
for university made 
excellent use 

of radar. 


magpi.cc/ 
audioradar 


P The radar system 
can sense distance 
and speed to varying 
degrees of accuracy 


W The innards of the 
device include a 
Raspberry Pi, USB 


sound card, amplifier, 


and loudspeaker 


16 | magpicc | Audio radar 


t’s well-documented that Raspberry Pi was 

created to help get people into computing, 

interesting them in a way that many 
people were during the 1980s. Dewan Pieterse, 
formerly of the University of Cape Town, worked 
on a system to help school and other university 
students get interested in radar. 

“The radar introduces the user in an easy 

and accessible way to electronics, [as well as] 
embedded systems and how radar detects return 
signals and performs filtering to measure radial 
velocity and distance to objects,” he explains. 


y 


The radar is based on a Raspberry Pi 3B which 
hosts a web server to enter the parameters needed 
by the radar to operate. “The web server can be 
accessed by connecting to the ‘RadarPi’ WiFi and 
starts to broadcast upon power-up,” says Dewan. 
“It is also used to display the results obtained after 
the radar was operated.” 


What's in a wavelength 

Normal radar uses radio waves (it was originally 
an acronym for RAdio Detection And Ranging); 
however, this version employs 8 to 12kHz of noise 
to measure distance - using the reflection time 
of the sound - and velocity, by making use of the 
Doppler effect. Parameters can be modified on 

a webpage generated by Raspberry Pi, allowing 
students to see how different settings change 

the results. 

*The radar proved to be a minor success in 
measurement of velocity, [although] with not the 
desired resolution and clarity due to the automatic 
gain of the microphone,” reveals Dewan. The 
automatic gain of the microphone automatically 
adjusts the received signals so that the signal 
never clips on the voltage range. When the velocity 
of a car is being measured, the microphone is 
overwhelmed by the road noise and the resulting 
plot is a quite faint line representing the velocity of 
the vehicle. 


RadarPi HOME CW-NT ew-T PULSED- NT PULSED-T 


Continuous Wave: Non-Technical 


This radar method is used to measure radial velocity. 
That means the velocity directly to, or from the 
radar. 


Set the time duration that a constant tone would be 
played out for and the volume. We recommend 5 
seconds. 


Mode 
Continuous Non-Technical 
Duration 
25-55 
Volume 


1,00 min - 100 max 


A Dewan's RadarPi software enables the user to enter radar 
parameters via an easy-to-use web interface 


Audio is played through 
the speaker, either ina 
continuous tone or in pulses 


M For distance measurement, 
the radar proved to be a 
Major success, with the 
only downside being the 
resolution of the plot Ø 


“For distance measurement, the radar proved 
to be a major success,” he adds, “with the only 
downside being the resolution of the plot. When an 
object was measured at a set distance, the results 
would display the range +10%. However, the known 
distance was always in the middle of the range and 
therefore a successful measurement. The reasons 
for the variation in distance was not investigated 
due to a time constraint, but initial tests proved 
that the automatic gain might be to blame." 


Accessible radar 

Dewan's system continues a long-running theme 
of projects involving radar, with this iteration 
trying to make it as open, affordable, and 
accessible as possible - which is why a Raspberry 
Pi was involved: *Raspberry Pi offered built-in 
wireless LAN and sufficient RAM capacity to host 
a web server,” says Dewan. “Other embedded 
systems, such as the STM32F04, were also 
considered, as a lot of previous work was done on 
this and the on-board analogue-to- digital (ADC) 
was also attractive. The STM and other Arduino- 
based systems had insufficient storage and RAM 
capacity, and therefore Raspberry Pi offered a 
superior solution." lil 
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A microphone listens for 
the reflected audio so 


calculations can be made 


» QR codes are 
used to access 
Raspberry Pi 


Dewan has 
since graduated 
from UCT 


v 


Ultrasonic sensors 
in robots use a 
similar system to 
detect distance 


v 


Sonar uses 
sound, but is 
usually employed 
underwater 


v 


Sound radars can 
also be known 
as SODAR (SOnic 
Detection And 
Ranging) 


v 


A web server is 
powered by Raspberry 
Pi and allows users to 


tweak the experiment 


To connect to WiFi 


제 Distance is 
calculated by 
measuring the time 
between the sound 
being emitted and 
then received 
after reflection 


Gj ssıD:Radari ` ae 
Passphrase: 1234567890 E 
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Tri-Lasers 
for Felines 


Keeping a modern cat entertained requires 
something more high-tech than a ball of yarn. 
Phil King wonders if this is a purr-fect project 


Enzo 
Calogero 


Enzo is a field 
data scientist, 
passionate about 
microcontrollers, 
Raspberry Pi, 

and 3D printer 
technologies. He 
enjoys creating 
loT devices to use 
in day-to-day life, 
along with robots. 


hackster.io/enzo2 


Warning! 
Laser eye! 


Don't look into a laser 
beam, and dont point 
a laser beam at a 
somebody's head. 
magpi.cc/lasersafety 


but as his owners live in a flat, he can 

get a little bored staying indoors when 
they’re out at work. Seeking a way to keep his 
cat entertained, Enzo Calogero came up with an 
ingenious Raspberry Pi-powered project. “We 
noticed that he loves to chase a laser light, so we 
decide to create a device to make laser games for 
him,” explains Enzo. 

The result is the Tri-Lasers for Felines device 
which, when the cat’s presence is detected by a PIR 
motion sensor, beams a laser dot around the room 
for Xander to chase between randomly generated 
points. Judging by the video on the project’s 
Hackster tutorial page (magpi.cc/trilasers), he 
seems to love it. 


X ander the cat is a much-loved family pet, 


Pan and tilt 

The laser's main movement trajectory is handled 
by mounting it on a Pan- Tilt HAT, which has 
vertical and horizontal servo motors. “A pair of 
coordinates (x, y) is generated randomly," explains 
Enzo. “The laser point moves from the current 
point to a new coordinate, following the segment 
that connects the two points, at a speed defined 

by a status variable. Once the new coordinates are 
reached, we loop back to point one." 

To add extra interest for Xander, its movement 
is randomised further by switching between three 
laser diodes to perform micro random movements 
very quickly. *Switching the active laser among 
the three allows extremely rapid movements of the 
laser dot, to create an extra variability of the light 
trajectories which seems more enjoyable for the 
cat,” says Enzo. 

While the laser point is visible in daylight, it 
shows up better when there's less light: *Xander 
prefers it when the room is completely dark.” 
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A Atilt sensor was added to shut down the device if 
interfered with by a curious cat 


The device's three laser diodes are set into a 
3D- printed triangular holder that sits atop the Pan- 
Tilt HAT's acrylic mount - which would normally be 
used to hold a Camera Module. Enzo also designed 
and 3D- printed a case for the PIR sensor. 


Cat-a-log 
In addition to handling laser movement, the 
Python script saves a log of Xander's activity: ^We 
check it now and then out for curiosity," says Enzo. 
“When Xander was a kitten, he was playing with 
it very often. Now he is a bit older and much more 
prone to sleep rather than play, we switch it on 
when we are out in the evening to keep him busy 
during our prolonged absence." 

One issue that came up is that, being naturally 
curious animals, cats are prone to investigate 
any new objects. “We try to put it as high and 


A PIR motion sensor turns — " 
on the laser when triggered 
by Xander's presence 
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Xander is a curious cat who 
likes to be entertained 


Xander prefers it when 
the room Is 
completely dark 


unreachable as possible, but cats are extremely 
skilled,” says Enzo. “So, he was able to reach the 
device few times. And the best way to save the 
device from cat attacks is to make it is as still as 
possible, so the cat loses interest.” 

Therefore a tilt sensor was added to the device, to 
cause it to shut down if triggered by an inquisitive 
Xander, thus reducing the risk of damage. 

This isn’t the only feline-focused project from 
Enzo, who has also built an IoT food scale to 
monitor when and how much Xander eats, sending 
the data to a Google Cloud online dashboard. He’s 
now working on a wheeled robot to track the cat 
with a camera and perform a few interactions — we 
wonder what Xander will make of that. 
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The device features three 
laser diodes mounted 

in a holder on a Pan-Tilt 
HAT to move it around 


The project took a 
couple of months 
to complete 


A Pan-Tilt HAT 
handles the main 
laser trajectory 


Three lasers are 
used to produce 
micro movements 


The software is on 
GitHub: magpi.cc/ 
ghtrilasers 


3D print designs are 
downloadable from 
magpi.cc/trilasers 


Three laser diodes 
are set into a 
3D-printed holder 
and mounted ona 
Pan-Tilt HAT to move 
the laser dot between 
random points 
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Raspberry Pı 
Recovery Kit 


Jay Doscher's tough cyberdeck could see you through 
the most testing of times. David Crookes logs on 


apocalypse, then Jay Doscher should do 

just fine. He’s created a rugged-looking 
laptop using a Raspberry Pi 4 computer and placed 
it within a small, air- and watertight Pelican case. 
Aimed at getting technology up and running in the 
event of a disaster, it should see him through the 


S hould the world ever be plunged into an 


Jay most testing of times. 

Doscher “Most people prioritise food and shelter in the 
event of a disaster, but what do you do when those 

Jay is an IT are resolved — how do you get technology working 


professional again?” he asks. “The apocalypse is more of a 
and technology 


" ; , ; 
enthusiast based in thought exercise for me, bur) ve certainly created 
the San Diego area. a very useful computer that is much easier to work 


He likes to focus on or modify than a regular laptop.” 
on open-source 


projects. He's on 


Twitter (@back7co) Past lessons 

and Instagram Jay has been here before. In 2015, he poppeda 
(@back7.co). Raspberry Pi 2 into a weather-resistant enclosure 
back7.co and created the Raspberry Pi Field Unit that could 


run off a 12V or higher power source, in this case a 

solar panel. Perfect for outdoor use, it also utilised 

an Adafruit real-time clock to retain accuracy 

when off the network. But it was far from perfect. 
“The Raspberry Pi Recovery Kit is an evolution 

of that previous build,” he says. “Although each 

has different goals, I wanted a Raspberry Pi setup 


> The Netgear switch 
to the left is securely 
held in place, while 
Raspberry Pi is 
mounted on the rear 
of the touchscreen 
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A Raspberry Pi 7-inch 
touchscreen display sits neatly 
in a self-contained compartment 


that fits the components and can 
be pulled from the Pelican case 


A The project uses a compact, smart ortholinear keyboard 
- that is, one which aligns every key to a strict grid rather 
than have a staggered key layout 


that could be rugged and work in a more hostile 
environment. 1 also wanted a system that could 
serve more than one purpose, since the Raspberry 
Pi platform is so flexible.” 

One of the first issues he looked to address was 
the original lack of a keyboard. This time around, 
he bought a Plaid keyboard kit and, to his delight, 
noted that it was a perfect fit for his Pelican 1300 
case. Jay also chose to use the official 7-inch 
Raspberry Pi touchscreen. This did away with the 
need for a mouse, while freeing up a much-needed 
USB port on Raspberry Pi 4. 

With attention paid to tight wiring and realising 
that he could get away with powering the unit using 
5V, thereby reducing the need for 12V circuitry, 
it wasn’t long before the project began coming 
together. “A Raspberry Pi computer is perfect for 
this project because it’s small, flexible on GPIO, and 


ag Maar 
m My d 


It's a regular Raspberry 
Pi laptop in many ways 


has great support for third-party add-ons like the 
GPIO breakout HAT I used,” Jay says. 


Future-proofing 
For a neat interior and to ensure all of the 
components could be easily held in place, internal 
parts were printed on a Prusa i3 MK3S 3D printer. 
For the host of connectors, a panel was produced 
with locking switches that could turn individual 
components on and off. These allowed control 
over Raspberry Pi 4, display, and Netgear five-port 
Ethernet network, saving power in a potential 
emergency. A switch also allows toggling between 
an internal and external battery. 

“The internal battery has been the most 
difficult part, and I am still working on that,” Jay 
says. "There are no real considerations on the 


MägPi 


No holes were 
drilled into the 


Pelican case 
Five Ethernet ports run down the l 


right side of the main unit. Vents 
above the connector panel and 


: NE ) kept watertight 
display keep air circulating 


3D-print 


internally and 


This smart connector panel externally 


can link to an external power 
supply, give access to the GPIO 
pins, and connect the keyboard. 
Switches can isolate power 


It's stored in an 


Here you can see 
how the connector 
panelis wired from 
the back and the 
positioning of the 
internal battery 


Raspberry Pi board itself for battery management, 
and Raspberry Pi 4 was pretty power-hungry when 
I built this kit.” 

Thankfully, coding proved easier. "It's a regular 
Raspberry Pi laptop in many ways, but I am working 
on scripts to mirror my GitHub projects, Wikipedia, 
and Raspbian APT libraries while following their 
guidelines on proper mirroring," he reveals. 

The result is a cyberdeck that can work as a 
portable standalone network core if needed. “It’s 
a great system to keep air-gapped from the rest of 
the network when not in use," Jay concludes. The 
battle for survival starts here. 
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The main frame 
took 24 hours to 


electromagnetic 
pulse shielding box 


The entire device is 


It can be powered 
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ULTIMATE 


Magic mirrors. How do they work? Are they really 


magic? Are they only for the advanced maker? 
PJ Evans goes through the looking glass 


out there. Initially created by combining old laptops and 

semi-reflective observation glass, they appear as normal 
mirrors but with text and images that appear to float in mid-air. 
The information displayed is typically what you need as you’re 
preparing to leave the house: weather, news headlines, and transit 
information. Although they come across as advanced builds, the 
community behind the projects have made significant advances in 
making magic mirrors accessible to all. Let’s take a look at one of 
these makers and then have a go at building our own mirror. 


M agic mirrors have to be one of the most popular projects 
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The frame needs to 
be deep and sturdy 
to accommodate the 
display and computer 


This is semi-transparent 
‘observation glass’: 
darker than a usual 

mirror, but it allows the 
display to show through 


MAGICMIRROR? 


Creating a good magic mirror requires 
experience in many disciplines including 
carpentry, electronics, programming, and 
graphic design. Fortunately, the team at 
MagicMirror?, headed by Michael Teeuw 
(see The MagPi issue 54, magpi.cc/54), have 
not only compiled tutorials and fostered a 
great community, they've also built their 
own open-source application. This modular 


system takes away all the programming 

and design pain. Best of all, you can expand 
the capabilities of your mirror through the 
hundreds of community plug-ins available 
and, if you wish, you can write your own. It's 
no wonder it won the number one slot in our 
best projects feature for issue 50. 


magicmirror.builders 


Information is displayed 
in corners, typically in 
high-contrast black 
and white 


A An LCD screen; for 

i best effect, it needs 
d to removed from its 
l d casing to sit flush 


= 


MagicMirror 


ee ee ee 
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Assembling a 


simple magic mirror 


Would you like a magic mirror, but don't fancy all that carpentry? Here's a first 
project to ease you in without having to reach for the band-saw 


here have been some impressive magic 
You'll Need mi = 
irror projects as makers around the 


> Ikea Ribba 18x24 
picture frame 
magpi.cc/ribba 


> Official Raspberry 
Pi 7" Touchscreen 
magpi.cc/ 
touchscreen 


> A5 observation 
mirror 
magpi.cc/a5mirror 


» Gaffer or duct tape 


» Velcro or foam 
Sticky pads 


Tip! Not for Zero 


A Raspberry Pi Zero 
would seem ideal 
for this project, 
but MagicMirror? is 
incompatible with 
that model and the 
original Raspberry 
Pi 1. 


globe challenge each other to improve 
on previous designs. Although the results are 
undoubtedly impressive, it can make the hobby 
look a little daunting to the beginner, especially if 
you don't have access to the necessary equipment 
to build a custom frame. In this tutorial, we'll 
assemble a simple magic mirror using off-the- 
shelf parts. This can be built in an afternoon and 
is a great way to find out whether you want to take 
it to the next step and get working on something 
a bit bigger. 


Prepare the frame 

To create our magic mirror, we will create 
a ‘sandwich’ of the frame, a piece of observation 
mirror acrylic, and the screen. It's vital that all 
these are kept as clean as possible during assembly 
as any dust will get trapped and leave an irritating 
mark on your lovely mirror. Unpack the frame, 
remove the mount, and then remove the plastic 
clear sheet. You'll need to carefully peel back the 


two protective layers and then replace the clear 
sheet in the frame. This is statically charged and 
will start to attract dust, so lots of cleaning is 
required. Return the mount to the frame. 


02 Mount the mirror 


The big ‘trick’ of a magic mirror is the use 
of two-way material, also known as ‘observation 
glass’. This material is the same that is used in 
police interview rooms and as privacy screening. 
It’s only semi-reflective, so the output from your 
screen can be seen ‘through’ the glass but it’s 
still effective as a mirror (if a little darker than a 
regular mirror). This material is cheapest when 
bought by the roll, so it’s ideal for custom-build or 
larger mirror projects. Ours is a £5 A5 acrylic sheet. 
Remove the protective sheeting and place in the 
frame, making sure it covers the open area. Secure 
with sticky tape. 


DI The big ‘trick of a magic 
mirror is the use of two- 
way material, also known 
as ‘observation glass' @ 


Add the screen 

We’re using the official 7-inch touchscreen 
for this project to make power requirements easier; 
we only need one cable to drive both Raspberry 
Pi and the display. It also happens to be a perfect 
size for this project. The touchscreen needs to be 
carefully placed so it’s in parallel with the frame 
and central. Secure with sticky tape. 


Raspberry Pi 4 can be 
mounted alongside 
the screen PCB so it is 
flush with the frame 


The simplest 
way to mount the 
screen is to use 
gaffer or duct tape 


Secure in place back of the screen with 

The combined weight of a Raspberry Pi insulation tape to avoid 
computer and the touchscreen doesn’t come to any electrical shorts 
much, so rather than getting into complicated and secure in place with 
mounting solutions, we will apply generous a Velcro pad to allow 
amounts of gaffer (or duct) tape to hold everything for future access to the 
in place. This is of course a very lo-fi solution - if microSD card. 


you want to go for something more refined, you 
can consider making use of the mounting points 
on the screen that can be used with horizontal 


or vertical bars to attach to the inner edge of the Check and test 

frame. Check for any trapped dust or marks in our With a microSD card 

‘sandwich’ before proceeding. with Raspbian installed, 
mount the Raspberry Pi 4 


into place. Check the display 
ribbon cable hasn’t been 


Just add Raspberry Pi stretched too much and 

Normally, you would mount a Raspberry the four jumper cables that 
Pi computer on top of the screen’s PCB on the connect the display to the GPIO Larger screen? 
provided standoffs. If you want to mount your are in the correct position. Better mount 
completed mirror on the wall, this poses a You should now be able to 
problem, as the computer now sits quite a way boot and see the Raspbian boot We've chosen 
proud of the frame. Your options are: 1) don’t care sequence through the display. It will probably Galfer tape, as 
(not advisable), 2) buy a second frame and fix it to look disappointingly dull. Don't worry, we'll ee 
the original to double its depth, or 3) mount the address that in the next tutorial. If everything is This ee 5 
Raspberry Pi computer on the side. We've gone free of dust, secured, and the display is working, terrible idea for a 
with option three and it just fits, even with the shut everything down (you may need to connect a ‘full-size’ monitor. 
supplied display cable. Make sure you line the keyboard and mouse to do this). 
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Setting up your 


Check you're looking good and fill your brain with useful 
information with your new frame and MagicMirror? 


! o far, we’ve got a frame built and ready to to see, then swap the microSD card when you’re 
| You'll Need S go. Next, we’ll look at how to set up your done. Go through the first-run wizard that helps 
~ Raspberry Pi computer to run MagicMirror?, you configure WiFi and updates all your software 
N a dedicated application for creating magic mirror to the latest version. 


previous tutorial) 


displays that takes all the hard work out of the 
software side of this project. MagicMirror? has 
been authored by Michael Teeuw, who created 
the amazing mirror in the beginning of this Make access easier 
Tip! feature. Not only does the software provide a Every time you want to make a 
diti ate plug-in system to control what’s displayed, it configuration change, it’s going to be a nuisance 
EE also configures your Raspberry Pi computer for to take the mirror down off the wall, locate a 

optimal performance as a mirror. That said, there keyboard, mouse, and possibly monitor to make 
are a few things to do, so let's get started. a simple edit. Instead we can use VNC and SSH 


to make life easier. VNC allows us to access 
the desktop remotely via VNC Viewer, which is 
available for many different platforms. SSH is 


First boot-up similar, but for the command line. To enable both 
In the final step of the previous tutorial, of these, open the desktop menu (the raspberry 
we checked that Raspberry Pi would boot correctly icon) and click on Preferences, then Raspberry Pi 
in its new home. If you haven't done this already, Configuration. When its window appears, click 
prepare a microSD card with an image of Raspbian the Interfaces tab and ensure VNC and SSH are 
or Raspbian Full (not Raspbian Lite, as we need enabled, but don't close the window just yet. 
W Aclearer view of 
the screen You can the desktop). If you have access to a second 
customise allthese identical Raspberry Pi computer, it might be 
panels and place them 5 5 7 E 
wherever you like easier to use that, as the display will be easier 


Set your host name 

To avoid your magic mirror bumping into 
any other Raspberry Pi computers you may have on 
your network, we strongly recommend setting the 
computer's host name (the name it is known as on 
the network) to something unique. Again, you can 
set this in the Raspberry Pi Configuration tool. On 
the System tab, choose an appropriate name such 
as ‘magicmirror’ (lower case, no spaces or special 
characters) and click OK. A reboot will be required 
for this to take effect. Once done, you can point 
your VNC Viewer or SSH client to magicmirror.local 
to gain remote access. 
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MagicMirror? defaults 
to a high-contrast black 
and white display which 

works well with the 
reduced visibility 


Tip! Restarting 
MagicMirror? 
If you have made 


a configuration 
change, you can 


restart without 
having to reboot 
by typing this at 
the command 
line: pm2 restart 
MagicMirror 


^ 14 


i 
(ie good today! 


Your maker. 


Photographing a 
magic mirror presents 
unique challenges 


Install MagicMirror? 

Now the fun part. MagicMirror? is an Electron 
app: a web app wrapped up in its own browser. 
Installing it manually is complex, but Michael 
and the team have provided an elegant script that 
automates the entire process. Get to a command- 
line prompt by using Terminal or an SSH client and 
carefully enter the following command: 


bash -c "$(curl -sL 
https://raw.githubusercontent.com/MichMich/ 
MagicMirror/master/installers/raspberry.sh)" 


(For more detailed instructions, see 
magpi.cc/magicmirror.) 

The script will now install Node (the 
programming environment that runs 
MagicMirror?), Electron, and the app itself. 


Configuring MagicMirror? 

During installation you'll see a lot of 
text fly by the screen, along with a couple of 
warnings that can be safely ignored. You will be 
asked at one point whether you want to install 
and enable pm2. Process Manager 2 (pm2) is an 
application that simplifies the running of Node 
apps (or anything else), starting things at boot or 


@ MagicMirror? is now installed 
and you should be able to 
see the display D 


automatically restarting apps when they crash. 

If you reply ‘yes’, pm2 will start MagicMirror? 
immediately on boot. You will also be asked if you 
want to start the app right away. If you're eager to 
see it in action, say yes. 


Initial configuration 

MagicMirror? is now installed and you 
should be able to see the display on your mirror. 
The installation process has tweaked a lot of 
settings to improve the display quality and has 
disabled things such as screen sleeping. You can 
customise what is displayed on screen and its 
position by having a look at the configuration 
file located at ~/MagicMirror/config/config.js. 
If you're finding the screen too crowded, you can 
tweak the layout by changing the value of ‘zoom’. 
We found 0.6 worked well for the Raspberry Pi 
touchscreen. We'll look into more of these settings 
next time. For now, go and get a hook and put up 
your new fancy magic mirror! 


Voice Control for 


your Magic Mirror 


Mirror, mirror on the wall, who's the fairest of them all? Whaddaya mean, ‘Alexa'? 


Get the right kit 
Reliable voice recognition requires a good- 
quality microphone. If you want to use services 
such as Alexa, you may want to add an 
amplified speaker too. The easiest 
options are widely available 
USB sound devices, many 
of which are compatible 
with Raspberry Pi. 


P The Snowflake mic is a great choice 


Choose your solution 
MagicMirror?'s plug-in system 
and amazing community means you have a wide 
choice of voice assistants with different purposes 
and capabilities. See magpi.cc/mirrorvoice for 
the current list of modules. 


MMM-awesome-alexa 


Install your module 

A good starting module is one called 
MMM-awesome-alex. Follow the instructions at 
awesome-alexa.js.org to install the module, then 
add your microphone and speaker to your mirror 
build, being careful not to ‘muffle’ the mic. Now 
your mirror is Alexa-enabled! Ell 


307.34 3f 18:09 


NEXT MONTH! 
Module Magic 


Next month we'll 
take a closer look 
at how modules 
are used to add 
more magic 
to your mirror. 
Keep an eye out 
for The MagPi 
issue 91. 


A Old monitors and TVs also make great mirror options, 
and you can still easily add voice control to them! 
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FIRST-PERSON 
~ SAOOTER | 


The theory behind 
first-person hitboxes 


à 
— 


Wireframe 


presents 


FIRST-PERSON 
SHOOTER 


Making a fast-paced 3D action game needn't 
be as daunting as it sounds. Build Your Own 
First-Person Shooter in Unity will take you step- 
by-step through the process of making Zombie 
Panic: a frenetic battle for survival inside a 
castle heaving with the undead. à 


Set up and use the free Create and texture 3D Make enemies that follow 
software you'll need character models and attack the player 


Design a level with Extend your game further, 
locked doors and keys with tips from experts 


Available now: 


" Magri | TUTORIAL 


Place Raspberry Pi 4 


in the stand so it sits 


vertically. This enables 


the ARM Cortex-A72 
CPU to run cooler 


Lucy 
Hattersley 


Lucy is editor of The 
MagPi magazine 
and enjoys tinkering 
with gadgets. She's 
been wanting to 
write this tutorial for 
a while now. 


magpi.cc 


| You'll Need 


> Raspberry Pi 4 


» Raspberry 
Pi 4 Stand (or 
cooling case) 


» Raspbian OS 


WK - 
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A 
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We take the ARM Cortex-A72 
CPU from its default clock 
speed to 2.147GHz and the 
GPU to 750MHz 


verclock 


aspberry P14 


Run your Raspberry Pi 4 faster with our guide to 
overclocking the CPU and GPU. By Lucy Hattersley 


Cortex-A72 CPU (central processing unit) 
running at a maximum clock speed of 
1,500MHz (or 1.5GHz). 

The clock is the electronic pulse used to 
synchronise all the components in a processor 
(foldoc.org/clock). A maximum clock speed of 
1.5GHz means the processor updates one-and-a- 
half billion times per second. 

This is the maximum speed: Raspberry Pi 
typically idles at 600MHz and switches to the 
maximum speed when needed. Overclocking is 
the process of setting a higher maximum speed 
for computer components. We can adjust the 
settings in config.txt to overclock both the CPU 
and GPU (graphics processing unit). 

We've experimented with speeds up to 
2.147GHz for the CPU and 750MHz for the GPU (up 
from its 500MHz default). These are the kinds of 
speeds found on high-end desktop computers. 


A t the heart of Raspberry Pi 4 sits an ARM 


34 | magpicc | Overclock Raspberry Pi 4 


Warning! 
Crash likely! 


Experimenting to find the 
highest stable overclock 
involves crashing 
Raspberry Pi 4. There is 
a chance of corrupting 
the microSD card. 
Experiment with a clean 
Raspbian installation 
and ensure no important 
data is at risk. 


Your mileage will vary, and if Raspberry Pi gets 
too hot it will slow right down. Experimenting 
with overclocking will crash Raspbian, and there 
is a high chance your Raspberry Pi will refuse to 
start at some point. If programs start crashing, 
or Raspbian refuses to start, you will need to dial 
back on the speed. But overclocking is fun and 
potentially a way to get more from Raspberry Pi. 


Raspberry Pi 4 Stand 

We start by placing Raspberry Pi4 ina 
vertical position. This improves airflow around 
the components and is surprisingly effective 
at keeping the temperature down (see Thermal 
Testing in magpi.cc/88). 

Use the Raspberry Pi 4 Stand on the front 

of the print edition of The MagPi #90 to run 
Raspberry Pi in a vertical position. If you don’t 


A Edit the config.txt settings to overclock Raspberry Pi 4 


have a Raspberry Pi 4 Stand, you can 3D-print or 
laser-cut your own with the files on our GitHub 
page (magpi.cc/github). 

Alternatively, place your Raspberry Pi inside 
a case designed to manage the CPU temperature 
(see our Thermal Cases group test on page 66). 


Update Raspberry Pi 4 
Make sure you are running the latest version 
of Raspbian OS. Tweaks to performance are being 
made all the time and you will hit faster speeds 
with the latest software. 
Open a Terminal and enter the following: 


sudo apt update 
sudo apt dist-upgrade 


Now reboot the system: 
sudo reboot 


This restarts Raspbian. 


Watch your speed 
Before we start overclocking, take a look at 
the default CPU speed. Open a Terminal and enter: 


cat /sys/devices/system/cpu/cpu@/cpufreq/ 
scaling cur freq 


Terminal will most likely return 600000. Divide this 
result by 1000 and you'll get the speed in MHz. This 
is the base speed: 600MHz (or 0.6GHz). 
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TopTip è 


Monitoring voltage 


It is essential to keep the supply voltage above 4.8V 
for reliable performance. Note that the voltage from 
some USB chargers/power supplies can fall as low 
as 4.2 V. This is because they are usually designed 
to charge a 37V LiPo battery, not to supply 5V to 

a computer. 

To monitor Raspberry Pi's PSU voltage, you will 
need to use a multimeter to measure between the 
VCC (5V) and GND pins on the GPIO. 

More information is available on the Raspberry Pi 
website (magpi.cc/powersupply). 


This is the speed requested by the kernel. If your 
Raspberry Pi is being throttled due to low voltage 
or over temperature, the actual CPU speed may be 
lower. To get the actual speed, enter: 


vcgencmd measure clock arm 


As you use your Raspberry Pi, the requested speed 
will boost to its upper level, which is 1588888. You 
can keep entering vcgencmd in Terminal to see 
where it's currently at, but it's better to use the 
watch command to monitor the speed. 


watch -n 1 vcgencmd measure clock arm W Insert Raspberry 


Pi 4 carefully into 
the stand, making 


This keeps vcgencmd running as a process and sureahedndented 
updates the result once per second (the -n 1 1896 same 
A " " 5 들 Side as the tour 
option is the interval in seconds). Start using your PoE pins. This holds 

H ) Raspberry Pi 4 on its 
Raspberry Pi and you'll soon see the result go side, enabling allow 
slightly above 1500000 (or 1.5GHz). around components 


Overclock Raspberry Pi4 | magpicc | 35 


" Magri | TUTORIAL 


47554560 


> Thewatch vcgencmd 
command is used to 
keep an eye on the 
current CPU speed 


Overclock your config 

We're going to use the config.txt file to set 
a new upper limit for the clock frequency. Open 
another Terminal window and enter: 


sudo nano /boot/config.txt 
Scroll down to the section marked: 


#uncomment to overclock the arm. 700 MHz is 
the default. 
#arm_freq=800 


And change the settings to: 


#uncomment to overclock the arm. 788 MHz is 
the default. 

over_voltage=2 

arm freq-1750 


Save the file with CTRL*O (press RETURN) and use 
CTRL*X to exit Nano. Restart your Raspberry Pi. 


TopTip & 


Overclocking problems 


Most overclocking issues show up immediately with 
a failure to boot. If this occurs, hold down the SHIFT 
key during the next boot. This will temporarily disable 
all overclocking, allowing you to boot successfully 
and then edit your settings 

Alternatively, remove the microSD card from your 
Raspberry Pi and insert it into another computer. You 
will be able to access the config.txt file and adjust 
the settings from there. 
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sudo reboot 


When the system starts up again, watch vcgendcmd 
again to see your new, faster clock speed in action: 


watch -n 1 vcgencmd measure clock arm 


Browse a few webpages and you'll see speeds 
around 1750000000 (or 1.75GHz). 


Understanding over. voltage 

The over. voltage command adjusts the core 
CPU/GPU voltage, and accepts figures between -16 
and 8. The default value is 0. 

More CPU speed demands higher voltage and if 
Raspberry Pi doesn't get enough volts, you will see 
a small lightning bolt appearing in the top right of 
the window (at this point, the CPU will be reduced 
to the 700MHz default speed). 


Crank it up 

Let's try taking things a little faster. We're 
going to take the over. voltage setting to 6 and set 
the ARM CPU to 2.0GHz. Edit the config.txt file 
with the following settings: 


over voltage-6 
arm freq-2000 


This is as high as we're going to take over. voltage. 

Reboot the Raspberry Pi and you'll be running at 
2.0GHz. Run watch -n 1 vcgencmd measure clock 
arm again to see the new upper limit. 


TopTip è 


Documentation 


See the ‘overclocking options in config.txt’ page on 
Raspberry Pi's website for detailed information on all 
overclocking options. magpi.cc/overclockingoptions 


07 Take it to the max 
Now we’re going to boost the gpu_freq and 
take the CPU to its highest setting. This enables 
Raspberry Pi to run at its current maximum speed. 
Use Nano to edit the config.txt file again, this time 
setting the arm freq to 2147 and gpu freq to 750: 


over voltage-6 
arm freq-2147 
gpu freq-750 


The gpu freq oversees a range of settings: 
core freq, h264 freq, isp freq, and v3d freq. 

The core freq setting adjusts the frequency of 
the GPU processor. It influences CPU performance 
because it drives the L2 cache and memory bus. 
The default value is 500, and 750 is the highest 
we can set it and still had a Raspberry Pi 4 run. We 
have also had Raspberry Pi 4 boards fail to boot at 
this speed, and others quickly slowed down from 
overheating or undervoltage. You are unlikely to be 
able to maintain this speed for the long term and 
your mileage will vary. 

Save the file and exit Nano (CTRL*O and 
CTRL+X). Reboot and your Raspberry Pi is 
hopefully running as fast as it can. 


Recover from black screen 

We have started a Raspberry Pi at speeds of 
up to 2.147GHz but some of our devices failed to 
boot, and others showed Undervoltage Warnings 
(thus reducing the speed). Eventually, we settled 
for arm freq-2000 in config.txt. Our engineering 
team told us that the benefits from gpu freq 
are marginal at best, and it should be removed if 
Raspberry Pi 4 fails to boot. 
Your Raspberry Pi will most likely fail to boot at 
some point when overclocking. See ‘Overclocking 
problems’ for more information on recovery. 
Otherwise, have fun and we hope you've enjoyed 
this excursion into overclocking. ZI 
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Firmware 
warning icons 


Under certain circumstances, the Raspberry Pi 
firmware will display a warning icon on the display, 
to indicate an issue. If you see these icons routinely 
appearing, you should reduce the overclocking 
Speed. There are currently three icons that can 

be displayed: 


Undervoltage warning 
If the power supply to the Raspberry Pi 
"A drops below 4.63V (+/-5%), this lightning 
bolt icon is displayed. 


Over temperature warning (80-85°C) 
If the temperature of the SoC is between 
i 80°C and 85°C, this icon is displayed. The 
ARM core(s) will be throttled back in an 
attempt to reduce the core temperature. 


Over temperature warning (over 85°C) 
If the temperature of the SoC is over 85'C, 
| this icon is displayed. The ARM core(s) and 
the GPU will be throttled back in an attempt 
to reduce the core temperature. 


m We're going to use the 
config. txt file to set a 
new upper limit for the 
clock frequency Ei 


DOWNLOAD 
config.txt THE FULL CODE: 


001. #uncomment to overclock the arm. 700 MHz is the default. 
002. over voltage-6 
003. arm freq-2000 


Overclock Raspberry Pi4 | magpicc | 37 


" Magri | TUTORIAL 


Dr Tracy 
Gardner 


Tracy is a computer 
scientist who spent 
ten years working 
as a software 
architect at IBM. 
She now writes 
educational projects 
for the Raspberry 

Pi Foundation. 


rpf.io/projects 


3D-print a keyring 
with BlocksCAD 


Use BlocksCAD to design, and print, a text-based keyring 


ast month we introduced our readers to 
BlocksCAD, a web-based program that 
can be used with Raspberry Pi to create 
3D printable objects. In this project, you will use 
BlocksCAD to design a ‘CODER’ keyring that can 
be 3D-printed. 

BlocksCAD is a 3D model editor that you can 
use in a web browser on a computer or tablet. You 
drag and drop code blocks to design 3D models 
that can be exported for 3D printing. 

If you have access to a 3D printer, then you can 
print your keyring. The keyring doesn’t use a lot 
of filament and is small and quick to 3D-print. 


r- 


The keyring will measure around 14 mm by 50 mm. 


You can put a split ring through the gap between 
the ‘C’ and the ‘©’ to make a keyring. 


M Rendering is the process of creating an 
image from a 3D model so that we can 
see what it looks like Ei 


| You'll Need 


» A3D printer and 
filament. Solid 
colours work best 


> Asplit ring for 
making the keyring. 
A 19mm diameter 
split ring works well 


» BlocksCAD 
blockscad3d.com 


3D Shapes 
2D Shapes 
abc 
Transforms A 10] 
B 


kd abc EZ 


length of abc 


Modules 
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Create 3D text 

Open the BlocksCAD editor in the 
Chromium web browser on your Raspberry Pi: 
blockscad3d.com/editor. You can drag and drop 
blocks to write code to create 3D objects (see The 
MagPi 89 for a BlocksCAD primer: magpi.cc/89). 

First, use the 3D text tool to create some 3D 
letters. Click on Text and then drag a 3D text 
block onto the canvas. Change the 3D text field to 
say ‘CODER’. 

Click the Render button to see the 3D text 
appear in the preview window. Rendering is the 
process of creating an image from a 3D model so 
that we can see what it looks like. 


Make the text bigger 

To make the letters bigger, change the size 
field to 20 - that means font size 20. Click Render 
again to see the result. If you 3D-printed the 
model you have created now, then you would get 


A Drag a 3D text block 
onto the canvas 


union 


The BlocksCAD code joins 
individual letters together to 
create the CODER keyring 


five separate letters, because they are not joined 
together. That wouldn’t make a very good keyring! 


50000: 


Join the letters together 
Next, you will join the letters together so 
that the keyring works as a single object. 

Change your existing code so that it only creates 
the letter ‘C’. Add a union block, from Set Ops, 
to join shapes together. Start with the first two 
letters: ‘C’ and ‘O’ (by creating a second 3D text 
block and adding both to the union block). 

Click Render and you'll see that there is a 
problem: the ‘C’ and the ‘©’ are in the same place. 
You need to move the ‘O’ along the X axis so that it 
comes after the ‘C’. 

Add a translate block, from Transforms, and set 
the value of X to 10 to move the ‘©’ 10mm along 
the X axis. 

Now, the letters should be touching, but not on 
top of each other. 
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» vw 


The preview window 
displays how the finished 
3D-printed object will look 


| - GIO (wow ` e (8) 


Low … medum O High 


{+} union 
3D text 
size E 


thickness 해 


Add the rest of the letters 

Click the [+] button on the union block 
to add a space for another block. Right-click on 
the translate block and select Duplicate to create 
a copy (of it and the 3D text block inside it). 

Drag the copy into the union block and change 
the ‘©’ to a ‘D’. Change the X value of the second 
translate block to 20 so that the ‘D’ is in the right 
place. Now, follow the same process to add an ‘E’ 
and an ‘R’ to finish the word ‘CODER’. 

Make sure that all of the letters are touching, 
and that there are no gaps between any of 
the letters. 


STL (Binary) * Generate STL 


how all x 


A The first two letters 
are now touching 


TopTip è 


Remove 
filament 


You might need 
to remove some 
small strands of 
filament to tidy up 
the print. 
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plus | (+) translate X D 30. Y. ‘oO 2 Rol 
E 


3D text 


size 


thickness 


SR: 
3D text R 
size 20 


thickness 


>» Addthe other letters 
to the union block to 
spell out CODER' 


. DOWNLOAD 
Coder Keyring THE FULL CODE: 


> Language: BlocksCAD © magpi.cc/blockscadkeyring 


plus (+) translate X "10 | Y Go 2 Lo! 
UTEM o 


t) translate X f 
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m To save your project, click 
on Project in the menu bar 
and select Save Blocks to 
your Computer D 


Change thickness 

Next, we’ ll alternate the thickness of the 
letters to help separate them, and to make our 
keyring even better. 

The letters are currently all 2mm thick; we want 
the make the ‘C’, ‘D’, and ‘R’ thicker than the ‘O’ 
and ‘E’, by making them 3mm. 

To do this, change the thickness value for the 
‘C, ‘D’, and ‘R’ 3D text blocks to 3, then click 
Render. Note that you can drag your model around 
to view it from different angles. You can also click 
an icon (to the right of the colour) to hide the grid. 


[+] (-) union 


3D text 
size 


thickness 


A Change the thickness value for three of the letters in 
the keyring to make it more interesting 


Save your project 
To save your project, click on Project in the 
menu bar and select Save Blocks to your Computer. 
Give your project a recognisable name and 
remember where you save it. You can then use Load 
Blocks from your Computer to open the project that 
you have saved and continue working on it. 


Mägpi 


A You can change 'CODER' to any message 
you like, and even create connected layers 
of text, as in this YOU ROCK keyring 


If you have a BlocksCAD account and you’re e 
logged in, then you can click on Project in the To p TI D 
menu bar and select Save. This saves your project 
online so that you can access it from any computer. Change colour 


You can click on the coloured square to change the colour of your model in the 
preview window. If you 3D-print the model, the colour of the keyring will depend 
on the colour of the plastic filament that you use, but it's useful to be able to try 


3D-print your keyring out different colours in the preview. 
BlocksCAD can export an STL file for 


3D printing. Render your model and then click 
Generate STL. Remember where you save the STL 
file. There are lots of tools that can read STL files 
and send 3D models to a printer. The one you 
choose will depend on the 3D printer that you are 
using. Carefully remove the 3D print from the 
print bed. Attach the split ring to your 3D 
printed keyring. hk. 
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Build an internet- 
connected room guard 


Protect your stuff from nosey parents, annoying siblings, or 
your nemesis with this easy-to-build motion-detection alarm 


Evans 


Awriter, developer, 
tinkerer, and Milton 
Keynes Raspberry 
Jam wrangler. His 
cat keeps setting the 
siren off. 


@mrpjevans 


Warning! 
Loud noise! 


The siren used in this 
tutorial is very loud 
(120 dB). Always use ear 
protection when testing. 


| You'll Need 


» 12V indoor siren 
and PSU 
magpi.cc/siren 


» HC-SR501 PIR 
sensor 
magpi.cc/pir 


» Automation HAT 
magpi.cc/ 
automationhat 


» Camera Module 
(optional) 
magpi.cc/camera 


Raspberry Pi, this tutorial is a great example 

of using our favourite little computer for 
physical computing, reacting to inputs, and 
doing something useful with the results. It also 
demonstrates some of the challenges you may 
face when handling different types of voltage and 
current. Here you'll learn how to make a simple 
motion detector that triggers a siren and sends 
an alert to your smartphone when it's triggered. 
You can then make the project your own through 
experimenting and adding more features. 


| f you’re just getting into making with 


Why an Automation HAT? 

Many Raspberry Pi physical computing 
projects directly use the GPIO to connect things 
like sensors, buzzers, and LEDs. In this case, 
we’re going use the incredibly versatile Pimoroni 
Automation HAT. This ‘input expander’ allows 
us to control devices that would normally either 
be incompatible or even damage your Raspberry 


A Figure 1 The PIR sensor's potentiometers (orange). Adjust 
carefully with a small screwdriver, as they can be fragile 
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Pi. As a small buzzer may not be particularly 
deterring to a would-be room invader, we’ve 
chosen a 120 dB siren that requires more current 
that our Raspberry Pi can safely handle. So, we 
will give the siren its own power supply and 
safely control it using one of the Automation 
HAT’s relays. 


Prepare your Raspberry Pi 

It’s up to you what model of Raspberry 
Pi you use for this project. A Raspberry Pi Zero 
W is more than capable of running the code and 
we originally prototyped our guard using one. If 
you’re thinking of getting clever, though, such 
as adding facial recognition using a camera, you 
might want to go for the horsepower of a Raspberry 
Pi 4. Either way, start by attaching the Automation 
HAT carefully to the GPIO header, and secure 
with the provided standoff posts on the opposite 
side to ensure the HAT doesn’t wiggle about and 
come loose. 


Set up the software 

We’re going to use Raspbian Buster Lite as 
the operating system as there’s no need for a user 
interface, just a basic command-line operating 
system. That said, there’s no harm in installing 
the full version if you’re more comfortable with 
that. Download the image from magpi.cc/raspbian 
and flash to a microSD card. Now, as ever, it’s 
time to login and update everything with sudo apt 
update && sudo apt upgrade. Once finished, run 
sudo raspi-config and set up networking (if using 
WiFi). Now, install the Automation HAT software 
by running the following command: 


These motion sensors use 


infrared to detect heat changes 
caused by moving objects 


curl https://get.pimoroni.com/automationhat 
| bash 


This will guide through setting up for driver 
software and examples. You may need to reboot 
your Raspberry Pi afterwards. 


Get sensitive 

The PIR sensor has three connectors: one 
for 5V power in (which can be provided by the 
HAT), ground, and in the centre is the data line. 
Operation is very simple. If the sensor is triggered 
by movement, the data line goes ‘high’ (outputs 
current). After a period of no movement, it goes 
low (no current). Its sensitivity can be controlled 
by adjusting one of the potentiometers (the left 
one when it’s turned upside down - see Figure 1). 
The other potentiometer sets the minimum time 
for which the sensor reports movement. We could 
connect the PIR directly to the GPIO, but as the 
HAT is now in the way, we'll use its inputs instead. 
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Pimoroni's Automation HAT 
allows the safe connection of all 
kinds of input and output devices 


4 Adding alert 
notifications allows 
you to keep on eye 
on things when 
you're away, and you 
can add images too 


TopTip è 


Any buzzer 
you like 


You don't have 
use a loud siren. If 
this is just for fun, 
maybe a buzzer 
may be better, or 
could it play a silly 
MP3 recording? 
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TopTip è 


Calibrate 
carefully 


Be patient when 
calibrating 

the sensor. 
Start with both 
potentiometers 
turned fully anti- 
clockwise, and 
work from there. 


YV There's plenty of 
scope for adding 
more to the 
project, such as an 
inexpensive keypad 
oracamera 


Connect the sensor 

Although this type of PIR sensor is widely 
available, they do vary in wiring. In particular, the 
orientation of Vcc (power in) and ground can be 
different. The sensor we’ve recommended here 
has both clearly marked on the PCB. Connect the 
ground pin to any of the GND connectors on the 
Automation HAT, then connect any 5V power 
output to the 5V in pin on the sensor. So that we 
know what state the sensor is in, connect the data 
line to any one of the buffered inputs on the HAT. 
Carefully check each of the screw terminals fora 
solid connection. 


Time for a test 

When you installed the software for the 
Automation HAT, examples and documentation 
were included. We can use these to quickly test and 
calibrate the sensor. From the command line, run 
the following: 


python3 ~/Pimoroni/automationhat/examples/ 
input. py 


You will now be shown the reading from all 

the input sensors. Watch the one to which you 
connected the data line in the previous step. It 
should report a 1 when it is activated (motion has 
been detected) and 0 when it ‘times out’. You can 
carefully adjust the two potentiometers on the 
sensor to fine-tune the sensitivity and timings to 
your preferences. Press CTRL+C to stop the Python 
script when you're done. 
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07 This might get loud 

The siren is capable of an ear-splitting 
120 dB. Always wear ear defenders in case you 
accidentally set the siren off. This particular model 
is tolerant of voltages less than 12V and the volume 
reduces accordingly. We recommend starting no 
higher than 5V, which is still incredibly loud. The 
siren requires its own power supply, so you'll need 
to source one (we recommend something with 
variable voltages so you can experiment with noise 
levels). Before continuing, make sure you’re happy 
with the siren’s noise levels. If you don’t want a 
loud siren, there are many buzzers and quieter 
alarms available that will work to demonstrate the 
project and will be much safer for younger makers 
to handle. 


띠 Always wear ear defenders 
in case you accidentally set 
the siren off D 


Relay race 

Relays are magnetic switches, allowing one 
device to control another without their circuits 
‘touching’. The Automation HAT comes with three 
relays and we'll use one to switch the siren on and 
off. Making sure it’s unplugged, snip the siren’s 
positive line (red wire) and strip a bit of wire on 
both ends. Now, connect the part going to the 
power supply to one of the relays on the terminal 
marked ‘COM’ (common). Connect the other part 
of the red wire to the same relay on ‘NO’ (normally 
open). Double-check everything and make sure the 
wires are secure. 


Software 

We can now read an input and create an 
output using the relay. Using your favourite editor, 
enter the roomguard.py code here. This is a simple 
loop that will check the sensor twice a second to 
see if movement has been registered. If so, the 
relay is switched into place, allowing current to 
flow to the siren and it sounds. Once the sensor no 
longer registers movement, the relay is deactivated 
and it all goes quiet. If you don’t fancy typing it 
in, you can download all this code and a few extras 
from magpi.cc/roomguard. 

To run the code, enter the following on the 

command line: 


A This project works well with Raspberry Pi Zero if you're 
keeping it simple 


python3 roomguard.py 


Try moving about! 


Add notifications 

We now have a working motion-detection 
alarm, but this is meant to be internet-connected, 
so let’s make it smarter. It would be useful to 
have a notification sent to a smartphone when 
the alarm is activated. There are a many different 
types of notification service, and adding support 
for most is possible using just one Python 
library, Apprise. Have a look at the code for 
roomguard_notify.py on GitHub for an example of 
how to add notifications. Also, check out Apprise’s 
documentation at magpi.cc/apprise. 


Add a camera 

Now the basics are working, you can 
augment the alarm with additional sensors 
and/or notifications. The Automation HAT has 
plenty of remaining inputs and outputs for you 
to play with. A simple step would be to add a 
Raspberry Pi Camera Module. See if you can change 
the code to take a photo of the intruder and then 
forward that image to your notification. Look at the 
GitHub repository for an example. 


Make it your own 

What else could you add? One aspect of an 
alarm not implemented is any kind of deactivation. 
Could you add a web server so you can control the 
alarm from your phone? How about using a keypad 
to set an activation code? There's potential to add 
batteries and additional PIR sensors to create a 
standalone unit. Use facial recognition software 
to identify who was in your room. There's lots of 
avenues to explore. Over to you. E 


roomguard.py 
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DOWNLOAD 
THE FULL CODE: 


» Language: Python 3 


© magpi.cc/roomguard 


001. 
002. 
003. 
004. 
005. 
006. 
007. 
008. 
009. 
010. 
011. 
012. 
013. 
014. 
015. 
016. 
017. 
018. 
019. 
020. 
021. 
022. 
023. 
024. 
025. 
026. 
027. 
028. 


import time 
import automationhat 


alarm sounding - False 


# A short delay so you have time to get clear! 
print("Arming in 10 seconds") 

time.sleep(10) 

print("Armed!") 


while True: 


# Check the current state of the PIR sensor 
motion detected = automationhat.input.three.read() 


# If new motion detected sound the alarm 

if motion detected and alarm sounding !- True: 
print("Motion detected, loud noise time") 
automationhat.relay.one.on() 
alarm sounding = True 


# If motion no longer detected stop the alarm 
if motion detected !- True and alarm sounding: 
print("It's all gone quiet, switching off") 
automationhat.relay.one.off() 
alarm sounding - False 


time.sleep(0.5) 


Ground 


qa close-up of 

the PIR sensor's 
potentiometers 
Carefully adjust with 
a small screwdriver 
as they can be fragile 


co ` ` 
GPIO 24v 28 wax Pen nevay [aM 


@.0000000000000 


SSSSESHHSCSHVSEHO/O 


5-12V PSU 
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Displays Cases Project Kits Add-on Boards 
HATs Arcade Cameras Cables and Connectors 
sensors Swag Power Options GPIO and Prototyping 


Partner and official reseller for top Pi brands: 


l M and many 
Wadatruit sparkfun, PIMORON — Senn others! 


"a S 


Mike 
Cook 


Veteran magazine 
author from the old 
days, writer of the 
Body Build series, 
plus co-author of 
Raspberry Pi for 
Dummies, Raspberry 
Pi Projects, and 
Raspberry Pi Projects 
for Dummies. 


magpi.cc/mikecook 


Warning! 
Power tools 


Please use safety goggles 
and gloves when drilling. 
sawing, and sanding 


| You’ll Need 


> MPR121 capacitive 
touch sensor 
magpi.cc/mpr121 


> Strip brass 1mm 
thick 50 mm 
by 300 mm 
magpi.cc/brass1 


> 2 x sheets of birch 
plywood 3mm 
thick A4 
magpi.cc/birch 
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Make beats ın style 
with Hex-A-Pad 


A stylish, capacitive touch sensor that can be used to trigger 
Sounds, and record and replay loops, direct from Raspberry Pi 


hexagons here at the Pi Bakery, and this 

month we were inspired by an Adafruit 
project (magpi.cc/adafruitmidi). While the 
aesthetic looked cool, there were things we didn’t 
like. The project required you to have access to a 
CNC milling machine and 3D printer, it was MIDI 
only, and used Bluetooth. So, we set out to design 
something you could make with normal workshop 
tools, much simpler electronics, on-board touch- 
sensitive controls as well as note triggers, and 
which would use the Raspberry Pi. 


A s you might know, we are very keen on 


Workshop tools used 

We used a disc sander, pillar drill, junior 
hacksaw, vice, and files. For cutting out the 
shapes of case, you can use a bench saw - we used 
the Proxxon KS230 circular saw - and fret-saw, 
or, if you have access to one, you can use a laser 
cutter. Either way, the files you need to use are on 
our GitHub page for this project. The technique 


A 


Figure 1 Top plate, cover, and sides. The file is pointing to one 
of the two tri-colour LEDs holes that might need enlarging 


A The Hex-A-Pad in all its glory 


for using a saw instead of a laser cutter is simple: 
just print out the PDF file for the part you need 
and glue it to the plywood. Then follow the cuts 
with the saw. Use a fret-saw for cutting out the 
central slots in the cover. 


The case parts 

Wear goggles and gloves 
The case consists of three hexagonal parts - 
base, top, and cover - along with six side panels. 
Figure 1 shows all the pieces. If you are not using 
a laser cutter, it is important that all the holes 
line up exactly. So first, drill all the holes in the 
top plate - note that there are two 2.5 mm holes 
and the rest are 3mm. Then clamp the top to the 
base and drill through the six holes in each of the 
corners of the hexagon. Countersink these holes 
on the underside of the base and the top of the 
top plate. Finally, drill the two ribbon cable clamp 
holes in the base. 
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4000 


Top Tip 


The control 
brass strips 


When cutting 
the control brass 
strips, you dont 
have to be too 
accurate with 
the 10mm width 
because the strip 
can overlap the 
control slot. 


magpi.cc 


These are the six 
sound triggers 


Software-controlled 


red/green/orange LED 


Making the cover 

Take the cover plate and drill two holes 
on opposite sides of the hexagon from the paper 
template. Then fasten the top plate and cover 
together using a nut and bolt through each hole. 
ext, drill through all the 3mm holes in the top 
plate into the cover plate to make sure that they 
line up exactly. Then countersink the six holes that 
are in the centre of each hexagon side closest to 
the edge, and also the holes at the top and bottom 
of the slots. Finally, drill, and countersink, the two 
2.5mm holes in the top plate. 


Set disc sander to 
60° 


1.5" 


| Slot at bottom 
| of 1 piece 


Figure 2 Lining up 
the side piece with 
the base 
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Control or extra 


sound trigger 


Making the sides 

To complete the box, cut out the six sides. 
You will notice that one side has a very small slot 
in it: this is for the ribbon cable to leave the box 
and is only 1mm deep - make it with a couple of 
strokes of a flat file. Each edge of each side piece 
needs to be bevelled at 60 degrees; we did this 
using a disc sander with the guide set to this angle 
using a 30/60 set square. The shape is shown in 
Figure 2; make sure the bevelled edges are done so 
that the side with the ribbon cable exit slot rests on 
the bottom of the case. 


Fixing the sides 

Each side is glued on initially using 
superglue. If you have used a laser cutter, it is 
important to sand the base edge to remove the 
crystallised resin from the wood, otherwise the 
glue will not stick. Carefully align the piece using 
three set squares, as shown in Figure 3, before 
applying glue to the base of the side and any 
adjoining side piece. Manoeuvre into place and 
press down (Figure 4). You might have to make the 
pieces slightly shorter if they are too big. When you 
have stuck all the pieces down, reinforce them with 
a fillet of glue around the inside edges. If you have 
a gap in any of the corner pieces, use wood filler 
and sand down for a smooth finish. 


A Figure 3 Lining up the side piece with the base 


Making the brass inserts 

The brass strip proved quite tough to work. 
If we had the tools, we would have annealed it to 
make it more workable: what is required is to heat 
it up until it’s cherry red and then leave it to cool. 
Nevertheless, we managed to cut it using a new 
hacksaw blade and plenty of lubrication - specialist 
cutting oil is best, but ordinary lubricating oil 
will do. We cut the strip into the shapes shown in 
Figure 5; first, a slice was cut off the strip and then 
the 30 degree slope from each corner. Always cut 
on the waste side of the line and finish off with a 
file or disc sander. 


MA slice was cut off the 
strip, then the 30 degree 
Slope from each corner Ej 


07 Painting the box 
We used a combination of PlastiKote Flat 

Black B2 and ‘Game Color’ Orange Fire 72.008 to 
paint the box. Using a fine P600 wet and dry grit 
paper, we smoothed down the wood after the first 
of two coats. Then we applied two coats of Ronseal 
matt clear varnish. The tops of the six-note trigger 
insert screws were painted black and the four 
control screws were painted orange, with the six 
corner holes screws painted Antique Gold B34 to 
match the brass. Note that only a small part of the 
top plate is seen, therefore you need only paint the 
corners of the top plate. 


Drilling the brass inserts 

We marked the brass control strips through 
the holes in the top cover and drilled them out 
3mm. Then we put the brass strips on, shown in 


51.00 


Trigger 


1mm Brass 


A Figure 6 All the 
brass inserts 


28.00 


51.00 


Control 
1mm Brass 
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< Figure 4 Gluing up 


the side pieces 


Figure 5 The brass 
inserts’ dimensions 


2 Off 


10.00 
Er 


37.00 


Control fill 
2mm Brass 


TopTip è 


Painting 
screw tops 


When painting 
the tops of the 
countersunk 
Screws, we used 
a lump of Blu 
Tack to hold them 
upright. We only 
use these for the 
final assembly; 
before that, we 
used unpainted 
screws for 

the many trial 
assemblies. 
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MPR121 
Touch sensor 


IRQ GPIO 4 (7) 
SDA SDA GPIO 2 (3) 
GC Pins | cx SCK GPIO 3 (5) 
3V3 3V3 (1) 
Gnd Gnd (9) 
8 
9 
Touch Pins 10 
150R 
150R 
4 5 Gnd 


mE GPIO 17 (11) 
240R 

Ge GPIO 18 (12) 

GPIO 27 (13) 
Wa Ya ~ 
VA Mi NS 
Blue Blue Blue 

240R GPIO 22 (15) 

2408 PIO 23 (16 

240R g ae 

P GPIO 24 (18) 
7 OG SJ 
Blue Blue ^ ]sue 


m The brass inserts need filing and sanding 
to remove sharp edges and corners Ü 


Raspberry Pi GPIO number 
(GPIO connector number) 


GPIO 18 (12) 


GPIO 27 (13) 


GPIO 22 (15) 


A Figure 7 Schematic 
of the Hex-A-Pad 


A Figure 8 Physical 
layout of the 
Hex-A-Pad 


|— GPIO 17 (11) 


mon 
sce) 
SDA (3) 


4 GPIO 24 (18) — 


Figure 6, and placed the top plate over them and 
tightened them up. Note: if the edge of the strips 
overlaps a portion of the LED hole, a few strokes 
with a rat-tail file above the hole makes sure the 
insert will not foul the hole. Each trapezoidal brass 
trigger was positioned to be at the edge of the 
hexagon and slotted underneath the cover, and the 
hole positions marked. They were then removed, 
drilled, and numbered with an engineer’s scriber in 
a place that would eventually be covered up. Do not 
enlarge the holes too much, as we need the edge of 
the screw to make contact with the brass. 
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Figure 9 


A Figure 9 Grounding copper foil 


Polish the brass 

First, the brass inserts need filing and 
sanding to remove sharp edges and corners. Run 
your finger over them to check all is smooth. The 
brass only needs to be polished up to the mounting 
hole. We used a P600 wet and dry grit paper - first 
dry and then wet - to remove any scratches, and 
finished off with Brasso polish. When installing all 
the brass for the final time, make sure you check 
continuity with a meter between the brass and the 
screw. If it is open circuit, then put a very small 
amount of conducting paint in the hole and try 
again. Similarly, conducting paint is used to fix the 
rectangular control fill pieces to the control strip to 
bring them closer to the surface of the cover plate. 


The schematic. 

The schematic of our circuit is shown in 
Figure 7. Basically, it is the MPR121 touch sensor 
breakout board and a bunch of LEDs. We used 
3mm blue LEDs for the key triggers controlled 
by GPIO outputs, and 3mm red/green common 
cathode LEDs for the control strip indicators, all 
in a diffused package. You might have to enlarge 
the two holes for these in the top plate to allow 
you to push them through. These were driven 
from four of the unused touch sensor connectors. 
Special registers inside this complex chip were 
used to make these four touch inputs into LED 
driving outputs. 
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simplesounds.py THE FULL CODE: 


» Language: Python e magpi.cc/pibakery 
001. #!/usr/bin/env python3 045. ifis-6: 
002. # Test the Hex-A-Pad touch sensors and LEDs 046. i2c.writeto(0x5A,bytes([0x79,0x30])) 
003. # with simple sounds 047. 
004. # By Mike Cook January 2020 048. def init(): 
005. import sys 049. global i2c, cap, capSenseNew, LEDs, sounds 
006. import time 050. global pygame, soundNames 
007. import board 051. i2c = busio.I2C(board.SCL, board.SDA) 
008. import busio 052. cap - adafruit mpr121.MPR121(i2c) 
009. import adafruit mpr121 053. capSenseNew = io.DigitalInOut(board.D4) 
010. import digitalio as io 054. capSenseNew.direction = io.Direction. INPUT 
011. import pygame 055. capSenseNew.pull - io.Pull.UP 
012. 056. LEDs - [] 
013. def main(): 057. LEDpin - [board.D17, board.D18, board.D27, 
014. global last touch 058. board.D22, board.D23, board.D24] 
015. init() 059. for i in range(0,len(LEDpin)): 
016. SetMPR121() 060. led = io.DigitalInOut(LEDpin[i]) 
017. last_touch = cap.touched() 061. led.direction - io.Direction.OUTPUT 
018. print ( 062. LEDs.append(led) 
'Adafruit MPR121 Capacitive Sensor Test') 063. cap.reset() 
019. print ('Press Ctrl-C to quit.') 064. it to see what you have 
020. while True: 065. print("I2C devices at",i2c.scan()) 
021. if not capSenseNew. value: 066. pygame.mixer.pre init(44100, -16, 12, 512) 
022. cur touch - cap.touched() 067. pygame.init() 
023. for i in range(0,8): 068. pygame.mixer.music.set volume(1.0) 
024. readPins(i, cur touch) 069. soundNames = ["ambi choir", "bass voxy hit c", 
025. last touch - cur touch 070. "drum splash hard", 
026. time.sleep(0.1) "drum tom hi hard", 
027. 071. "drum tom lo hard", "drum snare hard", 
028. def readPins(i,c touch) : 072. "bass voxy c", "loop amen full"] 
029. global last touch 073. sounds = [ pygame.mixer.Sound("sounds/"+ 
030. pin bit-1««i 074. soundNames[i]+" .wav" 
031. if c touch & pin bit and not last touch & 075. for i in range(0,len(soundNames))] 
pin bit: 076. 
032. print (i,"touched - now playing", 077. def setMPR121(): # top 4 sensor inputs to GPIOs 
033. soundNames [i]) 078. it turn off cap sense 
034. if i < 6 : LEDs[i].value = True 079. i2c.writeto(0x5A, bytes([0x5e,0])) 
035. if i== 7: 080. #gpio enable top 4 bits 
036. i2c.writeto(0x5A, bytes([@x78,@xC@])) 081. i2c.writeto(0x5A, bytes([0x77,0xf0])) 
037. ifi--6: 082. # control 0 control 1 direction 
038. i2c.writeto(0x5A, bytes([0x78,0x30])) 083. i2c.writeto(0x5A, bytes([0x73,0xf0])) 
039. sounds[i].play() 084. i2c.writeto(0x5A, bytes([0x74,0xf0])) 
848. if not c_touch & pin_bit and last_touch & 085. i2c.writeto(0x5A, bytes([0x76,0xf0])) 
pin bit: 086. # limit sensor to first 8 
041. print (i,"released") 087. i2c.writeto(0x5A, bytes([0x5e,8])) 
042. if i « 6 : LEDs[i].value - False 088. 
043. ifi=7: 089. if name == ' main ': 
044. i2c.writeto(0x5A,bytes([0x79, 0xC0]) ) 090. maint) 
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> Figure 10 
Photograph 
of wiring 


Y Figure 11 Ribbon 
connections to 
Raspberry Dis 
GPIO header 


Figure 11 Raspberry Pi 


GPIO 24 (18) i 
GPIO 22 (15) 
GPIO 27 (13) 
Hex-A-Pad GPIO 17 (11) 
GPIO 24 (18) 
GPIO 23 (16) Gnd (9) 
GPIO 22 (15) 
GPIO 27 (13) GPIO 4 (7) 
GPIO 18 (12) 
GPIO 17 (11) [] SCL (5) 
Gnd (9) 
GPIO 4 (7) SDA (3) 
SCL (5) 
SDA (3) 
3V3 (1) [] 3V3 (1) 


Starting the circuit 

The physical layout of this circuit is shown 
in Figure 8. Start with the copper foil backing for 
each sensor, which provides a good ground for the 
sensors. Figure 9 shows a photograph of the foil, 
with each strip connected by a small solder blob. 
The foil was also kept in place using some blobs of 
transparent Gorilla glue. Note the cut-out for the 
touch sensor board screws; this was fitted on M2.5 
screws and 5mm M3 nylon spacers. Note that the 
board was fitted with right-angle pins to keep a low 
profile. The LEDs are pushed through the holes into 
the cover, leaving them flush with the top surface. 


Building the circuit 

The resistors were mounted flat on the 
board to the LEDs and, when all were wired up, 
were held down in place by spots of hot-melt glue 
in the LED holes. Then the touch sensor wires 
were connected as shown in Figure 10. Finally, 


52 | magpi.cc | Make beats in style with Hex-A-Pad 


TopTip è 


Installing CircuitPython 


In a command-line Terminal, type the following: 


sudo apt update 

sudo pip3 install --upgrade setuptools 

sudo pip3 install adafruit-blinka 

sudo pip3 install adafruit-circuitpython-mpr121 


the connections to the ribbon cable were made - 
shown in Figure 11, along with where they connect 
to a 20-pin header which fits onto the first pins 

of Raspberry Pi’s GPIO. Note: pass the ribbon 
connector through the slot in the base before 
soldering up the 20-pin header socket. A small 
wooden bar with foam glued on the back of it stops 
the ribbon cable being pulled out. 


MA small wooden bar with 
foam glued on the back of 
it stops the ribbon cable 
being pulled out Ø 


Testing software 

The simplesounds.py listing shows 
some simple code that allows you to test all the 
LEDs and trigger some simple sounds. There 
is a sound for each of the six note triggers, as 
well as the two control bars. The sounds were 
taken from the Sonic Pi sample files, found at 
/usr/share/sonic-pi/samples, and converted into 
WAV files using Audacity. We will go more into 
the details of what is needed next month, but this 
software requires the installation of Adafruit's 
CircuitPython framework along with the MPR121 
driver. We had no trouble installing this under 
the Raspbian Buster operating system, but found 
when we used earlier versions of the OS it did not 
install correctly, throwing up errors. 


Next month, we'll look at software to drive the 
touch sensor chip in a more reliable way and also 

a fully fledged MIDI / sound sample keypad with 
effects control, sequence recording, and playback. El 
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Glade layout editor 
with C and GTK 


Use this layout editor to more easily create window layouts for applications 


s can be seen in the previous tutorials in so you need to use the correct one. The version to 
A this series, while creating widgets with create GTK 3 applications is called ‘glade’. And, 
GTK is a lot easier than doing it all from just to be perverse, the version you need to create 
scratch by writing pixels to screen buffers, you GTK 2 applications is called ‘glade-3’. (Yes, that is 
can still end up with quite a lot of code for even counterintuitive and quite annoying!) 
a fairly simple window layout, and you do have The first thing we need to do is to install glade-3. 
to think quite carefully about the code you are At a Terminal, type sudo apt-get install glade-3, 
Sinan tian writing to make sure the window looks the way and answer yes to any prompts. You should then 
is a software you want it to. It's also less than ideal that you have an entry labelled ‘Glade’ in the Programming 
engineer working can't actually see what the window will look like menu on your desktop. If you launch it, you'll see a 
a until you run the application. screen like the one shown in Figure 1. 
the Raspberry Fortunately, there is a way to work on the layout This is the basic design screen in Glade. On the 
Pi Desktop on of a window without having to write all its code, left side is a palette of all the widgets available. In 
both Raspbian and that is to use a layout editor. GTK allows the the centre is the area where you actually design your 
and Debian: layout of widgets on a window to be defined in an window, and on the right is an area which allows 
rpf.io XML file, which is then loaded and drawn on the you to set the properties of individual widgets. 
screen when the application runs - you still need 
to link up the behaviour of any widgets to code, but Using Glade to create a layout file 
the appearance of the widgets can be determined We'll create a simple window for our application, 
in advance. A layout editor is a useful tool to create so the first thing we need to do is to add a top- 
such an XML file. level window. Under the palette section labelled 
The most widely used layout editor for GTK ‘Toplevels’, the top-left entry is a GtkWindow - if 
is a tool called Glade. There are two versions of you hover over it with the mouse, a tooltip will 
Glade, one for GTK 2 applications and one for pop up with the label ‘Window’ to confirm this. So 
GTK 3 applications; they aren't interchangeable, just click on this icon to add a blank window to the 
design area in the centre of the screen (Figure 2). 
AnIntroduction | 
Poo idag 이 n 
(66060 
For further tutorials on how to start coding PROGRAMMING 
in C and creating GUIs with GTK, take a 
look at our new book, An Introduction to 
C & GUI Programming. Its 156 pages are 
packed with all the information you need 
to get started - no previous experience of 
C or GTK is required! 
magpi.cc/guibook 
A Figure 1 The Glade layout editor 


54 | magpicc | Glade layout editor with C and GTK 


File Edit View Projects Help 
(9 & B a. ge ci ME 
—|Actions *Unsaved 1 X 


(Jj C&] m oa eh 


Toplevels 
CES) m E (A) 
4588 

Containers 

| HB + 
Ee oo 34 200 
8 BL ES © »- 
LR A 


Control and Display 

[e] 00 o- a o- o 
Cm] DI sta (5: V? E] 
we pen D a» 
0 cm Å aman Xx 
EIER) a3 — E 
B-l» g 


+ Composite Widgets 


+ Tree Model 
+ Text Buffers 
+ Miscellaneous 


+ Specialised Widgets 
+/Gtk+ Obsolete 

GNOME User Interface 
lE DEI 나이 ma mV 


Let’s add a VBox to put some widgets in. The 
widget palette has a section labelled ‘Containers’, in 
which the first two entries are an HBox and a VBox 
- click the VBox, and then move the cursor into the 
blank window and click within it. A dialog will pop 
up asking how many items you want in the VBox - 
set it to 2, and click ‘Create’ (Figure 3, overleaf). 
You’ve now got a blank window with a line across 
the middle, showing the VBox. We’re going to 
add a label to the top, and a button to the bottom. 
Find these in the ‘Control and Display’ section of 
the palette - first click on each in the palette, and 
then click in the relevant section of the VBox in the 
design area to add them (Figure 4). 

If you look at the top of the right-hand column, 
you'll see the hierarchy of widgets being displayed 
- a GtkWindow, containing a GtkVBox, containing 
a GtkLabel and a GtkButton. If you click on one of 
the widgets in the hierarchy, the options displayed 
in the tabbed area at the bottom of the right-hand 
column will be those for that widget. 

Click on the GtkLabel, and scroll through the 
options on the ‘General’ tab; you'll find a section 
labelled ‘Edit label appearance’, including the 
entry ‘Label’ - use this to set the text in the label to 
whatever you want (Figure 5). 

Click on the GtkButton, and find the Label section 
for it - it's under ‘Label with optional image’ - 
change the label for the button to ‘Quit’. 

It's worth investigating the options on all the tabs 
at the bottom of the right-hand column - there are 
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Figure 2 


[I] Window Properties - GtkWindow [window 
General | Packing | Common | Signals (e 


Name window1 


Accel Groups: 

Window Type: | Top Level v 
Window Title 

Window Role: 

Resizable Yes 


Modal: No 


Window 
Position 
Default 

Width: z 
Default 
Height: 7 
Destroy with 


None E 


No 


* Figure 2 An 
empty window 


too many to go into here, but of particular interest 
are those on the ‘Packing’ tab; these allow you to 
set the expand, fill, and padding options which were 
available when adding widgets to boxes from code 

- if you play with them, you can get a good feeling 
for how much control you have over layout of the 
window, particularly when combining multiple 
boxes inside each other, as Glade allows you to do. 


m If two widgets have the same name, 
the layout file is invalid and will not 
load correctly @ 


The other thing that it is important to note about 
the right-hand column is that Glade assigns every 
widget a name - it can be seen in the hierarchy list 
at the top, and as the top entry on the ‘General’ 
tab. Glade assigns names as the name of the widget 
type followed by a number, but you can change 
these if you want. But there is one vital rule - every 
widget in a layout file must have a unique name. If 
two widgets have the same name, the layout file is 
invalid and will not load correctly. 

Your button and label widgets should have the 
names ‘button?’ and ‘label’, and your window 
should be ‘window?’ - remember these, as they 
are important when linking the code to the layout 
file. For now, save your layout as mylayout.glade 
by choosing the ‘Save As’ option in the ‘File’ menu. 
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» Figure 3 Adding 
a vertical box 


(You can select one of two different formats on the GtkBuilder *builder = gtk_builder_new (); 
save window - use the default GtkBuilder option.) 
Make sure you save the file in the same directory We then read the layout file into the builder. 


where you are storing your GIK source code. 
gtk_builder_add_from_file (builder, 


Using a layout file in a GTK application "mylayout.glade", NULL); 
Now we need to load the layout file into some GTK 
code. Try the following: The widgets we created in the layout file can now 
all be accessed by calls to gtk builder get object, 
#include «gtk/gtk.h» and used as before. So we get the object which was 


named windou1 in the layout file. 
void main (int argc, char *argv[]) 


( m To make the widgets 
gtk init (&argc, &argv); , 
actually do things, we need 
GtkBuilder *builder = gtk_builder_new (); " 
gtk builder add from file (builder, to connect signals D 


"mylayout.glade", NULL); 


GtkWidget *win = ( 


GtkWidget *win = ( GtkWidget *) gtk_builder_get_object ( 
GtkWidget *) gtk_builder_get_object ( builder, "window1"); 
builder, "window1"); 
gtk widget show all (win); And we show it as before: 
gtk main (); 
H gtk_widget_show_all (win); 
The gtk_init and gtk_main calls are the same as If you build and run this code, our simple window 
we have seen before, but the code between them should be displayed on the screen (Figure 6). 
uses a GtkBuilder, a code object which reads in and To make the widgets actually do things, we need 
processes a layout file. to connect signals as before, so let’s modify our 
We create a GtkBuilder object: code accordingly. 


56 | magpicc | Glade layout editor with C and GTK 


TUTORIAL | Mägpi "o 


Figure 4 *Unsaved 1 3 window] GtkWindow Figure 5 
: ojects Help e = Ejvboxi  GtkVBox | 
| Sv Y g 
Gee ZS ug w«labell — GtkLabel 
=]Actions *Unsaved1 X < widgets > 
Zw | WE l search widgets ==] ea button] GtkButton 
= = | (5 Dwindow1 GtkWindow | 
Se | = Bvbox1 GtkVBox | 
Se | mlabel1_GtkLabel | L | 
= 3«) Button Properties - GtkButton [button1] 
| 
| | General | Packing | Common | Signals | @ 
l u Appearance: E 
Button Properties - GtkButton [button1] a 
are z is (€) Configure button content 
e General | Packing | Common | Signals | € 9 
H e E 
| 5 E €» 
=|Control and Display | Name: button] i © Stock button 
DÉI 9- CB ©- Œ Border relief: | Normal d 
(m) (&) wee pi V Eg Focus on click: | Yes all 
wt mp D e» meme BE 
ce A m» en a. alignment for child: 
z Vertical alignment l 050 
를 689] GC) = f for child: Le (e) 5 = g 
- (€) Label with optional image 
E]}— | > e Response ID: j T 
*|Composite Widgets | Action Qui 
+)Tree Model | Belated Action: | Label: 
+] Text Buffers | Use Action 5 
+]Miscell Appearance: = TEST 
Ein Use underline: | No 
+/Specialised Widgets | © Configure button content , 
*|Gtk* Obsolete | p nz Image widget: 
=]GNOME User Interface | Ca 이 
P E DEI 나의 ma MZ B4 


* Figure 4 With a label 


Using layout files can make the amount of code anda buttenaddód 


you need to write a lot shorter, and the use of 
Glade makes it easier to create complex 
interfaces with more customisation of your 
widgets. For small applications with a simple 
window, it's probably more straightforward just 
to do everything in C, but for anything more 


A Figure 5 The widget 
properties editor 


void main (int argc, char *argv[]) 
1 complex, using a layout file can make the code a 


gtk init (&argc, &argv); 


GtkBuilder *builder - gtk builder new (); 
gtk builder add from file (builder, 
"mylayout.glade", NULL); 


GtkWidget *win - ( 
GtkWidget *) gtk builder get object ( 


lot more readable. 


Next steps 

One thing which should be obvious to anyone who 
has worked through this book and reached this 
point is that GTK is a fairly huge subject! There 
are dozens of widgets, and hundreds of different 
ways they can be configured and used - any 


comprehensive guide to using them all would run 
into several hundred pages. 

The best reference to GTK 2 - and the best 
place to find further information if you want 
to do more with it - is the official developer 
documentation, which can be found online at 
magpi.cc/gtk2manual. This gives far more detail 
on every aspect of GTK - the reference section 
listing all the functions associated with each 


builder, "window1"); 


Y Figure 6 The window 
created in Glade 
when run 


Figure 6 


gtk widget show all (win); 
gtk main (); 


} widget is particularly useful. 
Hopefully this series of tutorials has given CT ^ 
This time, we also get the button widget from the you an idea of where to get started with GTK : - : 
builder and connect the end program callback to it programming, and enough of a foothold to be able iQ u It: 


to experiment for yourself. 
Happy GUI designing! 7 


with g_signal_connect, as before. Build and run, 
and this time the button should close the program. 
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NEW PROJECTS! ^ 


LI LI 
Get inspired to make 
* LI LI 
| / something in 2020 
HA + new year means new plans. Sometimes 
A it's not easy to come up with a big cool 
* thing to work towards though, especially 

/ [7 x when it comes to making. 

~ ee 자 We're here to help. Whether you're making 
SE LINE your first project or wanting to try something 
new, we think we have you covered with a 
selection of projects to try, or just get inspired by. 


OU. 
| Aw Im If you need help figuring out what tools and 


accessories you'll need for all this, make sure to 


N x check out issue 89 (magpi.cc/89) for some big 
features that will help you out. Otherwise, let’s 
| | N get started. 


* 
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Babbage Bear 


Hello world! 


GET STARTED WITH 
THE TWITTER API 


Automate your tweets with Python 


Working with Python is fairly easy as programming 
languages go. You can do a lot more with it than just 
have it say Hello World, though, such as using it in 
conjunction with social media network Twitter! 

In this tutorial, you'll learn how to work with 
APIs - a way to interface with other programs and 
services - using Python and Twython, with the result 
being you can send tweets via Python code. This 
includes tweets with photos attached, and allows 
you to view a feed of tweets as well. Great for robots 
or online bots. 


magpi.cc/twitterapi 
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SHAKESPEAREAN 
INSULT GENERATOR 


Make cursing fun 


Python can be used for practical, interesting 
projects; however, it’s always important to 
have a bit of fun, like with this Shakespearean 
insult generator. 

It will teach you about some basic programming 
concepts, such as reading and writing data in CSV 
format using Python, manipulating lists, choosing 
random items from a list, and how to create a basic 
graphical user interface (GUI). These GUI skills 
can easily be translated to a lot of different Python 
projects and make them much easier to use. 


magpi.cc/shakespeareaninsults 


<espearea 


Thou puking milk-livered bladder! 


Insult me again 
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PHYSICAL PROJECTS 


GPIO MUSIC BOX 


Learn how buttons and other input 
components work with Raspberry Pi 


Coding is fun, but have you ever used Python 
code to interact with real-life objects? Using a 
simple push-button hooked up to the GPIO pins of 
a Raspberry Pi, you can control the way code runs. 
In this project, you'll learn how to program with 

a push-button so that specific button presses will 
play different sounds. 

This project makes use of both GPIO Zero - a 
library specifically created to make accessing 
components on GPIO easy - and Pygame, which can 
be used for programming video games in Python. 


magpi.cc/gpiomusicbox 


WHOOPI CUSHION 


Build a very custom button to 
prank your friends 


We could very easily lie here, without any 
reservations, that the reason we like this 
tutorial is because of the ingenious, DIY 
button that makes up a major part of it. 
However, it’s mainly just an excuse to make a 
digital whoopee cushion, which is hilarious. 

To be fair, we do also like the very DIY button 
made out of paper plates and tin foil and 
clips, and it's a great way to learn how you can 
bodge together your own buttons and sensors 
and such, while also pranking your parents, 
siblings, friends, roommates, or even your boss. 


magpi.cc/whoopi 
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m Get game design tips and 
tricks from the masters 


m Explore the code listings and 
find out how they work 


= Download and play game 
examples by Eben Upton 


m Learn how to code your own 
games with Pygame Zero 


This stunning 224-page hardback book not only tells 
the stories of some of the seminal video games of the 
1970s and 1980s, but shows you how to create your 
own games inspired by them using Python and Pygame 
Zero, following examples programmed by Raspberry Pi 
founder Eben Upton. 


Avallable now: magpi.cc/store 
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MINECRAFT 
PHOTOBOOTH 


Take real pictures using Minecraft Pi 


Minecraft on Raspberry Pi is quite different to 

other versions of Minecraft in that it is designed 

to be hacked and modded through Python code. THE PARE NT 
We particularly like this Minecraft project as it lets 

you use Python to bridge the gap between a virtual DE TE CTOR 
Minecraft world and the real world outside it. 

With a Raspberry Pi Camera Module and a little A motion-sensing camera that might 
code, you can take pictures of the real world using a help protect your belongings 
virtual button in Minecraft. There are even ways to 
display your photo in Minecraft if you really want to A parent detector for kids and a CCTV for the grown- 
challenge yourself. ups, this simple camera project allows you to control 
magpi.cc/photobooth a camera using a PIR motion-sensing component. 

This version is very simple, but you can also add 
many features in the long run - like a live web 
interface, backup camera-based motion sensing, 
and even motion-tracking motor control if you really 
fancy going all-out on the project. 

While this project uses Python and Raspbian, 
MotionEyeOS is an operating system for Raspberry 


Pi specifically built for CCTV stuff if you find the way 
this project works a little limiting. 


magpi.cc/parentdetector 
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CAMJAM EDUKIT 3 WITH CHASSIS ^ < 


An upgrade to the regular CamJam Edukit robot 


We talk about the CamJam EduKit 3 a lot - 
because it’s very good and very cheap. One thing 
that we think really elevates the build is this 
3D-printed chassis that turns the kit into a more 
recognisable programmable robot. 

The CamJam kit itself is also just a good way to 
earn about simple robotics with Raspberry Pi, and 
was created by the people that run Pi Wars, so it 
definitely has a very good pedigree. While it 
may not be what you use to enter Pi Wars, it’s 
definitely a step towards it. 


magpi.cc/edurobotchassis 


MONSTERBORG 


Build, program, race, and extend with the ultimate Raspberry Pi robot kit 


The CamJam kit is great for beginners, but the 
MonsterBorg kit is fantastic for people with a couple of 
robots under their belt. This robot is made by the boffins 
at PiBorg and used in the Formula Pi autonomous 
robot racing championship. This means it’s very 
quick, very sturdy, and very hackable. It can even 
flip over and drive upside down. 

With some extra modification, you can add 
more sensors and kit to the robot; with the 
great programming libraries available, it’s easy 
to incorporate them into your code, whether you’ re 
remote-controlling it or having it run autonomously. 


magpi.cc/monsterborg 
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RASPBERRY 
PI PROJECTS 


The Raspberry Pi Projects website is a massive 
resource for all things Raspberry Pi, from setting 
up your first Raspberry Pi to making robots and 
real-life photo-booths. You can filter by hardware, 
components, programming languages and more, 
and it’s a great way to learn just how much your 
Raspberry Pi can do. 


magpi.cc/projectsonline 


INSTRUCTABLES 


A veteran maker website that is chock-full of 
incredible, step-by-step projects that you can try 


to follow along to. You can find something for just 
about any type of hardware, and it’s easy to drill 
down to specific types of projects, or even just see 
what popular Raspberry Pi projects are on there. 


instructables.com 
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A GET SOME INSPIRATION! 


THE OFFICIAL BA 
RASPBERRY {| 
PI PROJECTS 
BOOK VOL. 5 


The fifth volume of our Official Raspberry Pi 
Projects Book contains 200 pages of amazing 
projects and tutorials that should help give you a 
huge boost of inspiration. There’s also a dedicated 
Raspberry Pi 4 beginner’s section if you’re brand 
new to Raspberry Pi. 


magpi.cc/projects-book5 * 


HACKSTER 


Hackster is a newer site, but it covers a similar 
selection of projects to Instructables, albeit with a 
stronger bend towards learning computing skills. 
You can still filter project types, but it’s easier to 
differentiate them by difficulty to make sure you 
don’t quite get in over your head. 


hackster.io 


Wireframe 


LIFTING THE BID ON VIDEO GAMES 
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NINJA STARS 
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aspberry Pi 4 - like all the other 
members of the ever-growing 
Raspberry Pi family - is entirely 
usable as is, and plenty of people 
appreciate the aesthetic of a bare board 
on a desk. 
For those who don't, there are a wealth 
of cases - both first- and third-party - 


Raspberry 
Pi 4 Stand 


Flirc Raspberry 
Pi 4 Case 


Argon One for 
Raspberry Pi 4 


Sensoreq CooliPi 
Heatsink and Case 


Pimoroni Aluminium Heatsink 
Case for Raspberry Pi 4 


The Pi Hut Raspberry Pi 4 Case 2.0 


magpi.cc 


available. You'll find one, the Raspberry 
Pi 4 Stand, mounted on the cover of this 
magazine, while the others in this group 
test can be found at all major retailers. 

Each case here has been tested for 
aesthetics, complexity of assembly, and 
its performance in keeping Raspberry Pi 4 
running cool. 


Raspberry Pi thermal case group test 


How we tested 


Each case was given a heavy 
synthetic workload to represent 
a worst-case scenario. This 
workload, which stresses 

both the central and graphics 
processors, runs for ten minutes 
followed by a five-minute 
cooldown period. Full details of 
the workload can be found in The 
MagPi issue 88, at magpi.cc/88. 


Raspberry P1 4 Stand 


> Free with issue 90 of The MagPi magazine 


REVIEW | MägPi mmm 


Made from a single piece of acrylic, the Raspberry Pi 4 Stand is as pure as it gets 


as a case could possibly be. Laser-cut from 

a single piece of acrylic, there's no complex 
assembly required: simply slot the stand between 
the Power over Ethernet (PoE) header and Ethernet 
port of Raspberry Pi 4 and pop it on your desk. 


T he Raspberry Pi 4 Stand is about as simple 
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Thermal imaging 


The Raspberry Pi 4 Stand improves the bare 
performance, but Raspberry Pi 4 still gets hot 
under sustained synthetic load. 


The stand is designed to improve cooling by 
aligning Raspberry Pi 4 vertically, rather than 
flat on a desk. Previous thermal testing in issue 
88 showed this is surprisingly effective, and the 
Raspberry Pi 4 Stand solves the stability issue 
which comes from balancing the board on its edge. 

There's a bonus trick up the Raspberry Pi 4 
Stand's sleeve, too: it holds up to three Raspberry 
Pi 4 boards side-by-side, making a very cost- 
effective computing cluster. Whether you install 
one, two, or three boards, the Raspberry Pi 4 Stand 
is surprisingly stable and not unattractive - and it 
retains access to all ports and headers. 


M The Raspberry Pi 4 Stand 
holds up to three boards 
side-by-side, making a very 
cost-effective cluster D 


Thermal load 


Without additional cooling, the Raspberry Pi 4 
Stand can't prevent Raspberry Pi 4 from hitting its 
throttle point during testing. 


= CPU Temperature CPU Clock == CPU Clock (Moving Average) 


Frequency (MHz) 


Temperature (Degrees Celsius) 


Testing Period Cooldown 


Time (Seconds) 


DIMENSIONS: 


120x20x2.8mm 


MATERIAL: 
Acrylic 


WEIGHT (inc. one 
RASPBERRY D 4); 


549 


NUMBER 
OF BOARDS 


SUPPORTED: 
Up to 3 


COOLING 
METHOD: 


Vertical 
alignment 


Verdict 


The Raspberry 

Pi 4 Stand is 
smart, free, and 
the only case on 
test to support 
more than a single 
board. Its cooling 
performance, 
though, is 

the weakest. 


Note! 

We don't score our 
own products. [We 
think our Raspberry Pi 4 
Stand is perfect - Ed.] 
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Flirc Raspberry Pı 4 Case 


> Flirc » magpi.cc/flirc » £16 / 516 


Designed to blend in with home theatre products, 
the Flirc case is undeniably attractive 


DIMENSIONS: 
93.7x66x26.5 mm 


MATERIAL: 


Aluminium 


WEIGHT (Nc. one 
RASPBERRY PI 4): 


1349 


NUMBER 
OF BOARDS 


SUPPORTED: 
1 


COOLING 
METHOD: 


Passive heatsink 
(SoC only) 


EXTRAS: 
Thermal transfer 
material pad 


Verdict 


Unless you need 
the GPIO, CSI, or 
DSI headers, the 
Flirc's few design 
flaws are unlikely 
to matter: the case 
keeps Raspberry 
Pi 4 well clear 

of its thermal 
throttle point. 


8 


reated as a means of 
C drawing attention 

away from Raspberry 
Pi 4 when used as part of a 
home theatre installation, the 
Flirc combines a matte-finish 
silver aluminium housing with 
soft-touch black plastic to the 
top and underside. It’s an understated 
design, but one which does compromise 
efficacy: the plastic lid covers much of the surface 
area of the aluminium case, reducing its ability to 
bleed off heat. 

The case itself makes contact with Raspberry 

Pi Ais system-on-chip (SoC) via a single hollow 
pillar and a bundled thermal interface material 


m Offers no ready access 
to the GPIO, CSI, or 
DSI headers D 


Thermal imaging 


The plastic lid prevents the Flirc from cooling 
entirely efficiently, while the hollow pillar can be 
seen as a cooler spot to the centre-left. 
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pad. Installation is simple, requiring only two 


protective sheets to be removed from the pad, and 


four screws to hold the case together. 

For those not interested in attractive home 
theatre setups, though, the Flirc comes with a 
major drawback: it offers no ready access to the 
GPIO, CSI, or DSI headers, though all external 
ports are easily reached. 


Thermal load 


Even with the lid in place, the Flirc case easily 
cools Raspberry Pi 4 during the synthetic 
workload run. 


= CPU Temperature CPU Clock == CPU Clock (Moving Average) 


Frequency (MHz) 


Kuer 


LU UN 


Time (Seconds) 


Temperature (Degrees Celsius) 


REVIEW | Magri mmm 


Argon One for Raspberry P1 4 


> Argon 40 >» magpi.cc/argon1 » £19/S25 


Impressively feature-packed, the Argon One offers a lot for 
your money - including temperature-controlled active cooling 


Ei Includes a smart power 
button to safely turn 
Raspberry Pi 4 on and off Di 


functionality into a surprisingly small 

footprint. A daughterboard connects to 
Raspberry Pi 4's AV and HDMI ports to re-route 
these to the rear of the case, alongside Ethernet 
and USB, while a second board pulls the GPIO 
header out to a colour-coded and silk-screen 


T he Argon One case packs a whole lot of 


labelled header hidden under a magnetic cover 
on the top. 
The same board powers a fan, which is 
active when the temperature exceeds a user- 
configurable limit, and includes a smart power 
button which can safely turn Raspberry Pi 4 
on and off with a press. There’s even 
space to route out CSI and DSI cables 
for a camera or display. 

Cooling performance is 
impressive. The Argon One prevented 
Raspberry Pi 4 from throttling 
without even needing to activate the 

fan - aided by the entire aluminium 
surface acting as a heatsink for the SoC and 
RAM chips. 


Thermal imaging Thermal load 


There's enough metal in the Argon One's 
aluminium upper shell to keep Raspberry Pi 4 
cool even under sustained load. 


After ten minutes of heavy load, the Argon 
One didn't even need to use its temperature- 
controlled fan once. 


== CPU Temperature CPU Clock == CPU Clock (Moving Average) 


Frequency (MHz) 


Temperature (Degrees Celsius) 


Dali ni 


Time (Seconds) 


DIMENSIONS: 
105x95.6x35 mm 


MATERIAL: 


Aluminium 


WEIGHT (inc. one 
RASPBERRY D 4); 


2309 


NUMBER 
OF BOARDS 


SUPPORTED: 
1 


COOLING 
METHOD: 


Passive heatsink 
(SoC, RAM), 
PWM fan 


EXTRAS: 
Thermal transfer 
material pads, AV 
daughterboard, 
fan, labelled 
GPIO header 
with magnetic 
cover, smart 
power board 


Verdict 


There's little to 
fault with the 
Argon One's 
design. Cabling is 
tidied, the GPIO 
header made 
more readily 
accessible, and 
there's more than 
enough aluminium 
to keep Raspberry 
Pi 4 cool. 
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Sensoreq CooliP1 
Heatsink and Case 


> Sensoreq >» magpi.cc/coolipi » From £39 / $52 


Featuring an open-source housing for a custom-milled 
heatsink, CooliPi is impressively extensible 


DIMENSIONS: 
92.4x86x54.3mm 


MATERIAL: 


Aluminium 


WEIGHT (inc. one 
RASPBERRY D 4): 


3209 


NUMBER 
OF BOARDS 


SUPPORTED: 
1 


COOLING 
METHOD: 
Passive heatsink 
(SoC, RAM, USB 
3.0 controller), 
optional fan 


EXTRAS: 
Case 3D print 
files supplied 


Verdict 


The CooliPi can't 
be faulted on 
performance. Its 
price, however, is 
an issue: starting 
at £39/$52 for just 
the heatsink and 
case, it'sthe most 
expensive product 
on test. 
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he CooliPi stands out from the 
T competition not just owing to 

its size and weight - it’s by far 
the heaviest case on test - but also by 
being at least partially open-source: 
while the custom-milled heatsink is 
available exclusively from Sensoreq, the 
plastic lower section can be printed on 
any 3D printer. 

That's only part of the story. CooliPi 
is a family of products, not just a case, 
and optional extras - some of which are 
also 3D printable - include a 90-degree 
adapter for Raspberry Pi 4's GPIO header, a HAT 
mount, and even a housing for an optional 5V fan. 


m The CooliPi stands out 
from the competition Dy 
being at least partially 
open-source Di 


Thermal imaging 


Having a very heavy aluminium heatsink lets the 
CooliPi absorb more heat than the competition. 
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The latter shouldn't be necessary outside the 
most extreme environments: in testing, the heavy 
heatsink of the CooliPi - which contacts the 


SoC, RAM, and USB 3.0 controller chips, with an 
optional copper shim available to cool the power 
management IC (PMIC) - was more than up to the 
job of cooling Raspberry Pi 4. 


Thermal load 


The CooliPi's large heatsink made it by far the 
best-performing cooler in the group. 


== CPU Temperature CPU Clock == CPU Clock (Moving Average) 


Frequency (MHz) 


Temperature (Degrees Celsius) 


Time (Seconds) 


REVIEW | MägPi mmm 


Pımoroni Aluminium Heatsink 
Case for Raspberry P1 4 


> pimoroni.com » magpi.cc/heatsinkcase » £12 / $13.20 


A compact two-part design, a few flaws don't 


stop this case performing well 


relatively straightforward two-part 
design, this all- aluminium affair aims to 
provide cooling and protection without 


taking up too much space - its overall footprint 
is only marginally larger than Raspberry Pi 4 on 


its own. 


There are a few issues, though, starting with 
aluminium cases, Pimoroni's 


its design. Like al 
heatsink case inc 
contact hot-runni 
the heat to the ou 
installation instru 
you to only add a 


the one in contact 
It turns out that this 
pillar targets a chip which doesn’ 


udes pillars desi 


gned to 


ng chips and transfer 


ctions, howeve 


tside of the case. 
r, tell 
thermal transfer 
with the central SoC. 

is because the RAM 


The 


pad to 


t get hot, 


m The pillar for the USB 
controller is too small 


and in the wrong place El 


Thermal imaging 


With so little metal to play with, the Pimoroni 
heatsink case gets noticeably warmer than 
the competition. 


DIMENSIONS: 
while the pillar for the USB controller is both too 88x56x22.4mm 
small and in the wrong place. 

This, and a patchy anodised finish, aside, the MATERIAL: 

Aluminium 


case does as promised: it prevents Raspberry Pi 4 
from throttling, and keeps all ports and headers - 
including GPIO, DSI, and CSI - readily accessible. 


WEIGHT (inc. one 
RASPBERRY D 4); 


1499 


NUMBER 
OF BOARDS 


SUPPORTED: 
1 


COOLING 
METHOD: 


Passive heatsink 
(SoC only, 

RAM and USB 
3.0 controller 
optional) 


EXTRAS: 
Thermal transfer 
material pads, 
hex key 


Thermal load 


Even contacting only the SoC, the case 
keeps Raspberry Pi 4 well below its 
throttle point. 


Verdict 


The Pimoroni 
Heatsink 

Case does an 
acceptable job of 
cooling Raspberry 
Pi 4, but feels 

like a missed 
opportunity. Fixing 
the USB pillar and 
adding one for the 
PMIC would have 


M M been welcomed. 
Time (Seconds) 6 


== CPU Temperature CPU Clock == CPU Clock (Moving Average) 


Frequency (MHz) 
Temperature (Degrees Celsius) 
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The Pi Hut 
Raspberry Pi 4 Case 2.0 


> The Pi Hut » magpi.cc/pihutpi4case ㅣ £10/$11 


A wholly acrylic creation, The Pi Hut's case relies on 
a small always-on fan to keep Raspberry Pi 4 cool 


he Pi Hut’s custom-designed 
| Raspberry Pi 4 case comes in 


sheet form, laser-cut from a 


DIMENSIONS: mixture of coloured and transparent 
An acrylic. Assembly is relatively 
MATERIAL: straightforward, though the plastic 
Acrylic mounting pillars and screws provided 
WEIGHT (c. one can’t withstand repeated assembly and 
RASPBERRY D 4): disassembly, and there are no thermal 
125g interface pads required. 
NUMBER Instead, cooling is provided by a single 5V 
OF BOARDS cooling fan installed beneath vents in the 
SUPPORTED: transparent lid. By default, this is set to suck air blow offers a 
1 out of the case and away; flipping it around to minor improvement 
COOLING in cooling performance at 
! the cost of a dramatic increase in noise. 
en D There 5 NO softwa re OF speed There’s no software or speed control for 
control for the fan, and it the fan, and it ties up the 5 V and GND pins on 
. . the GPIO header - which is inaccessible once 
tiles up the 5 V d nd G N D PINS assembled. The CSI and DSI headers are likewise 
locked away, though cables for these can at least 
on th e 6 p | 0 h eader DI be routed between the walls and the case lid. 
Thermal imaging Thermal load 
The acrylic lid effectively insulates Raspberry Despite its fan, The Pi Hut case’s cooling 
Pi 4, leaving the fan vent as the only place for performance is the second-worst on test - behind 
Verd | 다 heat to escape. only the Raspberry Pi 4 Stand. 
= CPU Temperature CPU Clock == CPU Clock (Moving Average) 
The Pi Hut case 
is a cheap option. 
Despite including 3 
active cooling, it A 3 
fails to outperform = d 
any of the passive B Š 
options on test $ E 
- bar only the in 3 2 
effect uncooled E 
Raspberr YA UN 
Pi 4 Stand MAN I 


4 


Time (Seconds) 
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Argon 


Designed for Raspberry Pi 4 


REVIEW | MägPi mmm 


And The Winner Is... 


end-all of choosing a case for Raspberry Pi 4 
— in fact, as our testing in issue 88 proved, 
under most real-world workloads Raspberry Pi 4 
is more than capable of handling itself. 
It’s little surprise, then, to find every case on 
test - except the Raspberry Pi 4 Stand - passed 
the demanding thermal throttle benchmark with 
flying colours. 


T hermal performance isn’t the be-all and 


m Any should prove more 
than adequate to prevent 
thermal throttling Di 


What is perhaps surprising is the variance within 
the tests. The Pi Hut case’s fan isn’t as effective as 
passive options like the Pimoroni Heatsink Case 
and the Flirc - and while the CooliPi is the best 
performer overall, its high price and bulk make for 
a difficult case to recommend for most use-cases. 

Under real-world conditions, any of the cases - 
including the Raspberry Pi 4 Stand - should prove 
more than adequate to prevent thermal throttling. 
Only those operating Raspberry Pi 4 in relatively 
extreme environments need worry about cooling - 
and there's nothing wrong with picking your case 
based on features, accessibility, price, or aesthetics 
instead, opening up the whole group as potential 
winners depending on personal taste and budget. Hl 


Winner: Argon One 


The Argon One ticks almost every box: it's attractive, 
includes a wealth of features, cools well, and won't 
break the bank. 


Case cooling 


Temperature (Degrees Celsius) 


Time (Seconds) 


== Stand = Flirc == Argon One == CooliPi 


== Pimoroni Heatsink Case == Pi Hut Case 
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Pirate Audio 
Headphone Amp 


AUDIO 


PROCESSING: 
PCM5100A 

DAC (24-bit 

/ 192kHz), 
PAM8908 
amplifier chip 


DATA BUS: 
PS for audio, 
SPI for LCD 


DISPLAY: 
240x240 IPS 
colour LCD 


AUDIO OUT: 
3.5 mm stereo 
jack 


CONTROLS: 
4 x tactile 
buttons 


> Pimoroni » magpi.cc/pirateaudio » £20/ $21 


Create your own mini MP3 player with this DAC audio board, 
complete with an LCD to show track details. By Phil King 


audio boards offering high-quality 

sound output, but Pimoroni's new Pirate 
Audio range adds a mini LCD to show music 
track details and album art. In this review we're 
focusing on the Pirate Audio Headphone Amp, 
but we also tried out the other three models: 
Line-out, 3W Stereo Amp, and Speaker. We 
understand that another model is also set to be 
added to the range soon. 

All the boards have the same slimline pHAT 

form factor that fits perfectly onto a Raspberry 
Pi Zero, although they'll work with any 40-pin 
model. The main difference between them is 
how the sound is processed and output. On the 
Headphone Amp, audio is amplified and then 
output via a 3.5mm jack - just plug in your wired 
headphones or earbuds. The positioning of the 
jack on the side of the board means you may need 
to take your Raspberry Pi out of its case, or raise it 
up using a booster header. 


R aspberry Pi has its fair share of DAC 


m it delivers excellent sound quality with 
a warm tone, plenty of fine detail, and 
sufficient bass for our ears El 


» 


Just plug in a pair 
of headphones or 


earbuds and enjoy your 


favourite music, from 


local storage or Spotify 


Setting it up 

Getting started with Pirate Audio wasn't quite 
as simple as we anticipated, although an 
online guide (magpi.cc/pirateaudioguide) has 
since appeared that should prove very helpful. 
Installing the default software itself is simple 
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enough, by entering three commands in a 
Terminal window. This does everything needed to 
configure the DAC and enable SPI for the LCD. 

Based around the Mopidy music server daemon 
(mopidy.com), the software enables you to play 
local music files or stream tracks from Spotify, 
although you'll need a premium account for that. 
The Spotify extension for Mopidy is installed 
automatically, along with one for the user- 
friendly Iris web interface. 

The latter proves essential as you'll need to use 
it to actually start playing music on the board. 
Point a web browser to your Raspberry Pi's IP 
address appended with ‘:6680/iris’ to access the 
web interface - you can do this from another 
computer or on the same Raspberry Pi if it's 
connected to a monitor. 


Accessing local media files required a change 
to the Mopidy config file to reassign the local 
directory from the default to our Music folder, 
then running a local scan in Iris to find the files. 

For Spotify streaming, you'll first need to 
authorise the device via the Mopidy website, alter 
the config file to enable Spotify and add your 
credentials, and then sign in again via Iris to start 
using Spotify from its interface. Tip: if you still get 
an error when trying to play files, try restarting 
the server from Iris’s settings. 


Music to our ears 


The good news is that once you get everything set 
up, the Pirate Audio board's 24-bit, 192kHz DAC 


PIRATE AUDIO RANGE 


REVIEW | MägPi mmm 


제 The front of the board 
features four tiny tactile 
control buttons on either side 
ofthe colour LCD screen 


delivers excellent sound quality with a warm tone, 
plenty of fine detail, and sufficient bass for our 
ears. At first, we found it a bit too loud - until we 
flicked the switch on the rear of the board from 
high- to low-gain (recommended in most cases). 

The volume level can be adjusted using two tiny 
control buttons on either side of the LCD. The 
other two buttons present are for play/pause and 
skip to next track in the queue, album, or playlist 
- there's no way of returning to previous songs 
unless you use the web interface. 

We do love that built-in LCD, though, which 
shows you the track details on a background of the 
blurred album artwork, with a song progress bar 
at the bottom. El 


Eé Verdict 
Ka 


Quas JE, 8 


A little tricky to 
get it all working, 
but once set up, 
the resulting audio 
is of excellent 


It's All Good 


Dë ` quality and the 
h e N vi » ie = LCD is great 
e i ] i ] for showing 
LINE-OUT 3W STEREO AMP SPEAKER track details 


Aimed for use with powered 
speakers or by connecting to a 
hi-fi line input, it features line- 
level digital audio and a 3.5 mm 
stereo jack. 


This board features four tiny push- 
fit terminals on the rear to attach 
wires from passive speakers. 
There's also a switch for stereo and 
mixed-down mono modes. 


At only 1W, the small built-in 
speaker isn't very powerful and 
sounds rather tinny, but this board 
is ideal when you need integral 
audio for a portable project. 


and artwork. 


9, 10 
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RetroF lag GP1 Case 


> The Pi Hut > magpi.cc/gpicase » £60/$79 


oe PJ Evans takes retro gaming on the go with this 
WEIGHT: eighties-handheld-inspired case with screen 
1389 
DISPLAY: f vow " i i i à 
2.8-inch IPS | you're serious about retro gaming and Full and clear instructions are provided to 
would like to be able to play all the games in install support for the gamepad buttons and also 
POWER: all the places, the RetroFlag GPi case might the on/off switch that provides easy and safe 
3 x AA batteries just be your new best friend. More than a simple shutdown. We found the unit easy to assemble and 
or'USB enclosure for the Raspberry PI Zero, this rather had RetroPie running in no time at all. We were 
COMPATIBILITY: familiar-looking unit is a full-blown battery- particularly impressed by the screen, which uses 
Raspberry Pi Zero powered gaming console that (just about) fits in IPS rather than TFT to give a razor-sharp display 
or Zero W (not the palm of your hand. from any angle without any of the common side- 
Zero WH) lighting issues. A small audio speaker is built-in, 
Game on with the option of headphones. The case itself is 
The clever design of the GPi replicates that of injection-moulded, solid, and beautifully made. Hl 
eighties handheld consoles, including a cartridge- | | 
like unit that slides out of the rear and is quickly Mere 


disassembled to reveal space for a Raspberry Pi comfortable in hand and 

x the controls are well-placed 
Zero. A very neat ‘pogo’ mounting system means 
no header or soldering is required: a Raspberry 
Pi Zero just slots in and pressure maintains the 
contacts. The reassembled unit then slots into the 
main body and you’re ready to go. You can even 
access the microSD card without removing the 
‘cartridge’. Power is supplied by three AA batteries 
or a supplied USB cable. 


Gams 


Verdict 


This is one of the 
best gaming cases 
we've seen. A 
great design, easy 
assembly and, 
most of all, great 
fun to use. An 
essential 
purchase for any 
retro gamer. 


10. 
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Use Raspberry Pi 4 as a desktop 
PC and 4K home media centre 


Be inspired by incredible 
projects made by other people 


Learn how to code and make 
with our step-by-step tutorials 


Find out about the top kits and 
accessories for your projects 


EN Magri | REVIEW 


0 Best: 


ame 
making 
projects 


Learn how to make game software and 
hardware with these cool projects 


hen you have a bit of a coding hobby, you 
W inevitably end up thinking about making 

your own game. Luckily, in this brand new 
decade, it could not be easier to find resources to help 


you get started. Here’s how to begin making games 
with a Raspberry Pi. 7 


a PICO-8 


128 by 128 pixels of fun 


Over several issues of The MagPi, Dan Lambton-Howard shows 
you how to use PICO-8 to create your own 8-bit wonder game 
made up of very limited pixels. Time to get creative. 


magpi.cc/83 
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4 Interactive tabletop RPG map 


Roll for initiative 


Upgrade your board games and tabletop games with this interactive map 
screen that can be used by a game master to gradually reveal dangerous 
dungeons or put up the next game board to play on. 


magpi.cc/86 


v Build an 
arcade cabinet 


Learn how controllers work 


What better way to learn how 

you can attach all the necessary 
peripherals - buttons, joysticks, 
speakers, lights, screens, etc. - toa 
Raspberry Pi for games than building 
a full arcade cabinet! 


magpi.cc/63 


4 Scratch Cat 
goes skiing 


Scratch-based gaming 


Scratch is well suited to making 
games, with code scripts specifically 
tied to sprites/images. If you fancy 
wanting to learn the basics of coding 
while making a game in the process, 
check out this fun skiing game. 


magpi.cc/catski 


How to program games 
with the LOVE gaming engine 


The next step 


LOVE uses Lua, a popular language 
in game development, and this guide 
takes you through how it works in 
relation to Scratch - very useful for 
people just starting out with coding 
and game making. 


magpi.cc/lovegame 


3D robot Pac-Man 


A reimagined classic 


An oldie but a goodie, Pac-Man 
actually has Al for the individual 
ghosts, giving them unique 
movements/personalities. This 
version brings it to real life, adding an 
extra dimension in the process. 


magpi.cc/66 


4 Flappy astronaut 


Simple and educational 


CCTV cameras with Raspberry Pi are not too difficult to put together. We 
like this project because it also uses computer vision and face detection to 
recognise known people. 


magpi.cc/flappyastro 


Make games with Python 


Shoot-'em-up with Python 


We put out an Essentials guide in 2015 which included a step-by-step guide 
to making a shoot-'em-up space game using Pygame, an amazing game 
programming library in Python. 


magpi.cc/gameswithpython 
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Simon says build this 


This Simon clone device built by Les Pounder is a great example 
of a more physical game, and could even be used for the basis of 
a controller for a virtual game displayed on a screen. 


magpi.cc/pymon 


^ Make games in C 


Delve deeper into dev 


A while ago we had a long-running series on coding games in C 
in The MagPi, starting in issue 65. Covering coding as well as basic 
game design theory, it was written by Brian Beuken, who teaches 
game programming at university. 


magpi.cc/65 
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mmm Magri | RESOURCES 


Learn Python 
with Raspberry P1 


Learning Python in 2020? PJ Evans catches up on the latest resources 


+ New ` E Open Œ Seve Æ Samples Settings B Run 


le EduBlocks as 


Y Statements 


S = Loge 
S Joshua Lowe As great a choice as Python J d 
E is for your first adventure E tor om ED 
5 @ S Loops 
E Price: in coding, many start with turie = color | 00082 = 
zl FREE : Reser i 
O Scratch (scratch.mit.edu), a A C wu e 7 
edublocks.org fantastic free online coding PRA cov ce 
environment that teaches the END) 


© craps 


fundamentals of coding using 
visual ‘blocks’ to build up the 
set of instructions. Scratch is 


% Random 


@ Processing 


taught all over the world and is 

especially popular in schools. So EduBlocks, which bridges the concerned about the next step 
what happens when it’s time to gap between visual block-based in your coding adventure, this 
transition to a more formal form coding and Python. Simply create is the ideal place to play and 

of coding? Scratch can only take your Scratch-style program, click ` experiment. You'll see that there 
you so far, but the move to ‘all a single button, and pow, there's isn't that much difference after 
text' Python can be daunting, the equivalent Python code ready all. The main site is supported 
especially to younger coders. to cut and paste. by an extensive collection of 
Joshua Lowe agreed and (at EduBlocks is online and tutorials and worksheets, many 
the age of just twelve) created completely free. If you're designed for Raspberry Pi. HI 


Free Online Courses 


Learning that won't hurt your wallet 


YOUTUBE DEEP LEARNING PREREQUISITES: PROGRAMMING FOR EVERYBODY 
Yes, it sounds obvious, but it's hard to THE NUMPY STACK IN PYTHON (GETTING STARTED WITH PYTHON) 
overstate how many great resources are Numpy (an extensive mathematical toolkit) How about learning about Python from the 
available on YouTube. The offerings from was a game-changer, promoting Python to University of Michigan? This highly rated 
freeCodeCamp and Programming With a major player in machine learning. This free beginner's course features both tutorials and 
Mosh are particularly recommended for Course gives you a solid grounding in these assignments, is available for free, and comes 
Python beginners. advanced principles. with online support from instructors. 
magpi.cc/youtubepython magpi.cc/udemynumpy coursera.org/learn/python 
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| Learning loT with | 
Python and Raspberry Pi 


Premium 


Dr El Horvath & This impressive 760-page 


learningiot.net 


that goes from your first line 
of code to creating real-life 
Internet of Things projects. 
Although it’s intended to 

be picked up by academic 
institutions and implemented 
as a course, there’s no reason 
not to self-teach if that’s the 
style that works for you. 

As well as a solid grounding 
in Python, from first principles 
to advanced techniques such as 
threading, its detailed projects 
include reading environmental 
data with Sense HAT, using GPS, 
and robot control. In addition to 


physical computing, there are 
many projects on interacting 
with the ‘cloud’, such as storing 
remote data and alerting. 


a Checkio 


CREATOR 


CheckiO 


Price: 
£10 / $10 per student 
(first class free) 


checkio.org 


PEE 2.077 folowors 


What’s better than learning 
through gaming? CheckiO is a 
10096 online series of courses 
intended for the classroom, 
although individuals are also 
welcome. Through a series of 
over 200 tutorials, worksheets, 
and challenges, the participant 
starts with the fundamentals and 
writes more and more complex 
code as the principles of gaming 


Partners: 


Wë 


are revealed. Throughout, there’s 
an excellent support system, 
including the ability to discuss 
solutions with your peers. A 
scoring system and awards make 
this great fun for the classroom. 
If getting into the games industry 
appeals, or you just fancy 
creating some homebrew and 
don’t know where to start, this 
might be the perfect choice. El 


EX 

E Dr EA Horvath epic has been created by Learning loT Python 

HI . accomplished academics to with Python? and Raspberry Pi® : 

ab provide a complete course Serious about 
£95 / $125 


Python knowledge? 
These are for you 


PYTHON - FROM 
BEGINNER TO WINNER 
This is a more structured course 
than others we've mentioned 
here. A total of three hours of 
video and 21 downloadable 
resources with coding 
exercises. Recommended 
for those wanting to learn in 
bite-size sections. 
magpi.cc/udemypython 


CODE THE CLASSICS 
What could be better than 
learning through recreating 
the golden era of arcade 
gaming? This book (yes, from 
ourselves) teaches many 
fundamental principles of 
code while having some 
classic fun. 

magpi.cc/ctc1 


CODE COMBAT 

Although aimed at the 
classroom, Code Combat is 

an epic collection of Python 
programming challenges 
wrapped in a sophisticated 
and fun user interface. You can 
play around for free. 
codecombat.com 
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WEE 1200: | INTERVIEW 


W Pranjali tries to make 
sure that girls get 
plenty of input to make 
up for the gender bias 


Pranjali Pathak 


Bringing computer science to underprivileged children 
in India is a priority for this engineer turned educator 


> Day job Program lead | 
ike a few educators in the 
L Raspberry Pi and digital 
making community, 
Pranjali Pathak of the Pi Jam 
Foundation started out life as 
an engineer before becoming 
a teacher. She’s been a fellow 
for Teach for India, where she 
taught students from grade 3, 
and brought that experience 
to the Pi Jam Foundation as a 
Program Lead, making sure 
educators are supported when 
teaching computing. 
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> Community role Community support | 


“Pi Jam Foundation is a 
Section 8 (not-for-profit) 
organisation,” Pranjali tells us. 
“The organisation is entirely 
impact driven and aims to 
provide all students from under- 
resourced schools [with] 
computing and problem-solving 
skills, which are essential for 
them to succeed in the 21st 
century workplace. Using low- 
cost, open-source technology, 
Raspberry Pi and a contextual 
research-based curriculum 


> URL thepijam.org 


coupled with innovative 
pedagogy, PiJam Foundation 
aims to provide quality computer 
education to over 100,000 
students across India by 2022. 
We have successfully brought a 
globally relevant, yet contextual 
computer science education to 
8000+ students across under- 
resourced schools across urban, 
suburban, and rural geographies 
of the country.” 


What are your links to 
Raspberry Pi? 

We work extensively on 
Raspberry Pi [computers] across 
all our Pi Lab programs and feel 
the Code Clubs would enable us 
to enhance our curriculum and 
provide students from different 
grades and diverse economic 
backgrounds access to 
knowledge at par with global 
standards. Also, being [more] 
affordable than existing PCs in 
the market lends itself to use in 
the context we operate in, i.e. 
under-resourced public schools. 


What kind of events have you 
put on/supported? 

Pi Lab is an award-winning 
flagship programme that 
enables a complete computer 
science ecosystem (Raspberry Pi, 
best of open-source tools, and 
highly contextualised curriculum 
and teacher training 


programmes) that ensures year- 
long learning and allows kids to 
explore, tinker, and create. 
Currently, Pi Jam is impacting 
8000+ number of students 
through 40 Pi Labs across [...] 
the country. 
The Pi Labs, especially the 
ones in under-resourced schools, 
have been places of immense 
transformation of thought and 
possibility for our students. They 
have seen technology and 
computer science as something 
the more privileged classes had 
access to, and using Raspberry Pi 
computers] has helped us give 
them the same (if not a more 
focused and holistic) access. 
We see career possibilities 
change as they experience the 
true creativity behind technology, 
and have even encountered them 
sharing with us that they always 
assumed technology to be boring, 
but the Code Clubs were very 
exciting for them to be a part of. 
Annual Showcase ‘Makers 
Factory’: PiJam’s Annual 
Showcase takes place every 
February, where our students are 
provided with a platform to 
present their solutions in the 


Pi Lab is an award-winning 
flagship programme 


form of technology prototypes to 

problems identified by them. 
Hackathons: for students, 

members from the community, 

mothers of the Pi Lab 

students, [and] individuals 

from corporates. 


What kind of people attend 
these events? 

The students hail from 
communities that have a rich 
mix of people from different 
cultures, beliefs, and languages. 
The lack of resources and 


rampant poverty unite residents 
of this locality. Most of the 
communities are home to tens of 
thousands of children, many of 
whom lack access to a good- 
quality education. 

All the students come from 
low-income households, and a 
majority of their parents are 
first-generation migrants from 
other states. Additionally, most 
of the students do not have any 
formal knowledge or prior 
experience to computers across 
these schools. 


Pranjali Pathak 


4000 


People from all 
backgrounds attend 
the events 


Pi Jam 
projects 


Rukaiya's parents 
were fruit and veg 
sellers; however, a 
problem with the 
vendor meant some 
fruit was rotting and 
affecting the rest of 
the supply. Unable to 
inspect the boxes by 
eye, Rukaiya created 
a rotten fruit detector, 
which used a stick 
with an MQ3 sensor on 
the end which would 
smell out rotting fruit 
in the box. 


During the monsoon 
season, it's not 
uncommon for autos 
(motorised rickshaws) 
to get stuck in 
manholes. Several 
students had to 
abandon a taxi auto at 
the urge of their driver 
and felt bad for him, 
so decided to create 
a system that warned 
the driver in the future 
of open manholes in 
the road ahead. It's 
incredibly accurate as 
well, even being able 
to detect if a manhole 
is slightly tilted open. 
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This Month ın 
Raspberry Pı 


Big birthday list! 


Here are just some of the Raspberry Pi events celebrating its eighth birthday 


turning eight this year! Or two, if you only 
count leap years. Either way, in honour 
of this birthday, any Raspberry Jams taking place 
between Saturday 15 February and Sunday 15 March 
can be used to celebrate Raspberry Pi! 
Here are the events that have been planned by 
the time we go to print. For a more up-to-date list, 
head to rpf.io/jam. El 


A s we mentioned last issue, Raspberry Pi is 
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BLC Raspberry Jam 
Buxton 


CamJam 
Cambridge 


Chelmsford Raspberry Jam 
Chelmsford 


Exeter Raspberry Jam 
Exeter 


Gateshead Raspberry Jam 
Gateshead 


Leeds Raspberry Jam 
Leeds 


London Raspberry Pint 
London 


Beeston Raspberry Jam 
Nottingham 


South Devon Tech Jam 
Paignton 


Cornwall Tech Jam 
Redruth 


Sheffield Raspberry Jam 
Sheffield 


Southend Raspberry Jam 
Southend-on-Sea 


York Big Birthday Pi Jam 
York 


LCE? 5 
-Ra>P BERRY P 


e e & 


I. 


$ 


USA 


aoc 
Lts © doit! 
Prime 


Raspberry Pi Birthday Jam 
(9 California High School 


California 


Fresno Ideaworks Pi 
Day Party 


California 


Raspberry Jam Catoosa 
Georgia 


Jelly's Raspberry Jam Party 
Maryland 


Raspberry Pi Big Birthday 
Jam Ann Arbor 


Michigan 


Los Alamos Raspberry Jam 
New Mexico 


TEC Raspberry Jam 
Tennessee 


Raspberry Pi 8th 
Anniversary Celebration! 


Utah 


Roanoke Raspberry Jam 
Virginia 


Columbia Basin Jam 
Washington 


Raspberry Jam WV 
West Virginia 


Raspberry Jam Zelzate 
Belgium 


Varna Raspberry Jam 
Bulgaria 


Raspberry Jam des inspirés 
2020 
France 


Votanikos Jam 
Greece 


AmsterJam 
Netherlands 


CoderDojo Baarle Raspberry 
Birthday party 


Netherlands 


PiWars 
Turkey 


Rest of the World 


Litoral Raspberry Jam 
Argentina 


Raspberry Pi JAM 
Buenos Aires 


Argentina 


Santiago del Estero, 
Argentina Raspberry Jam 


Argentina 


Inverell Raspberry Jam 
Australia 


Calango Raspberry Jam 
Brazil 


Raspberry Jam Sao Paulo 
Brazil 


Pi Jam @ PiLabs 
ndia 


Raspberry Pi Jam Kochi 
ndia 


Abhinav Raspberry Jam 
ndia 


Atria Labs Raspberry Jam 
ndia 


Bhopal Raspberry Jam 
ndia 


PiWorld Raspberry Pi Jam 
ndia 


ResPro Labs 
Raspberry Pi Jam 


India 


Pi Jam 2020 @ SRiX 
Warangal 


India 


Raspberry Jam NextTech 
India 


Itierio Boys’ High School 
Raspberry Jam 
Kenya 


Perak Technology Academy: 
Raspberry Pi Jam 
Malaysia 


Jam Kathmandu 
Nepal 


Ikeja Tech Mates 
Raspberry Jam 


Nigeria 


Pi Day with Free City Hacks 
Nigeria 


Davao Raspberry 
Birthday Jam 


Philippines 


Sufu Raspberry Jam 
Senegal 


Bangkok Raspberry Jam 
Thailand 


Dubai Raspberry 
Birthday Jam 


United Arab Emirates 


Magri mmm 
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MagPı Monday 


A Brian Corte & 
| have been working on my #PiWars robot a A book - coming soon! 


away my code for the control/menu of a @Raspberry Pi 


e orionrobots 


Replying to @TheMagPi 


based robot. More details here 


github.com/OpenPiRobotics. 


Explorer 
HAT tricks 


fun things to try with your Pimoroni Explorer HAT 


ROMILLY COCKING 


Hello, lve been 3d printing a mount to link the 


Raspberry Pi camera with Lego technic (for a robot of 
course), and mentoring Raspberry Pi makecode Arcade 
at @CoderDojoHam with @rdhayler . 


Amazing projects direct from our Twitter! 


01. 


02. 


03. 


04. 


05. 


06. 


07. 


This looks like a scene 
from Short Circuit 


Good luck with 
the book! 


3D printers make 
custom robot work so 
very easy 


Clock stretching is 
a tricky bit of code 
magic 

Good use of 

an Energenie 


This monster looks 
familiar. Crumbs, we 
can't place it.. 


The image doesn't 
do this justice: it is 
extremely fast 


very Monday we ask the question: have you 

made something with a Raspberry Pi over 

the weekend? Every Monday, our followers 
send us amazing photos and videos of the things 


they’ve made. Here is a small fraction of them. 
Follow along at the hashtag #MagPiMonday. 7 


Mark Bush 
@BikrSpeedTriple 
Replying to @TheMagPi 
Implementing the C64 user port to control electronics 


in BASIC in the amazing #8MC64 app. (Also for C128, 
VIC20, and PET!) 


Michael (Mike) Horne 
@recantha 


Replying to @TheMagPi 


I've been testing out the AmbiMate MS4 sensor 
package from @TEConnectivity te.com/usa-en/product 
... and finding out about the perils of I2C clock 
stretching recantha.co.uk/blog/?p=19880 


Dr Footleg - Roboteer 
@drfootleg 
Replying to @TheMagPi 


| made my fastest Raspberry Pi robot yet: 


@ Dr Footleg - Roboteer @drfootleg ㆍ Jan 1 


First robot build of 2020. | present Turbo Tiny. A test bed chassis for my robot 
HAT. 


8 Bits and a Byte 
@8BitsandaByte 


Replying to @TheMagPi 


An internet controlled monster :) 


Translate Tweet 
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4000 


Best of the rest! Here are some other great things we saw this month 


SANIA BOX | NOVELTY RADIO PC 


This is a Kickstarter for a special add-on board 
for Raspberry Pi that is aimed at teaching code to 


eight-year-olds, with an initial idea coming from a We think this is very cute - Reddit user carecoin took 
13-year-old. The add-on board has LEDs, a push-button, a tiny novelty radio and put a Raspberry Pi Zero W 
thermal sensor, touch sensor, light sensor, and an and screen into it. There's no banana for scale, but it's 
environmental sensor for gases. very small. 

kck.st/38fj9pd magpi.cc/noveltypc 
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[ 1 


aspberry Jam 
vent Calendar 


Find out what community-organised Raspberry 
Pi-themed events are happening near you... 


01. Exeter Raspberry Jam 


© Saturday 1 February 

Q Exeter Library, Exeter, UK 

» magpi.cc/jM5Qp7 

A meeting for everyone interested in all things 
microcomputers, microcontrollers, robotics, and making. 


02. St Louis Raspberry Pi Jam 

© Saturday 1 February 

® Danforth Center, St Louis, MO, USA 

> magpi.cc/HunpKi 

An event where makers can work in a collaborative group 
on a project, or just learn about makers and making. 


03. Melbourne Raspberry Pi Hackers 

^ Sunday 2 February 

® Library at The Dock, Melbourne, VIC, Australia 

» magpi.cc/cHa3y8 

A meet-up open to everyone with an interest in 
electronics, robotics, making, 3D printing, laser cutting, etc. 


04. Barnstaple Raspberry Jam 

5 Saturday 8 February 

Q9 Barnstaple Library, Barnstaple, UK 

» magpi.cc/sVtkkf 

A friendly bunch of Raspberry Pi enthusiasts who meet 
once a month to share ideas. All ages and abilities welcome. 
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05. Cornwall Tech Jam 


© Saturday 8 February 

Q9 Bodmin Library, Bodmin, UK 

» cornwalltechjam.uk 

For anyone interested in technology. of all ages and 
abilities. Ask questions and learn about programming. 


06. Manchester Raspberry Jam 

© Saturday 8 February 

Q The Shed, Manchester, UK 

» magpi.cc/hyNWr8 

A monthly user group where attendees can take part in 
taught workshops or get help working on their own projects. 


FULL CALENDAR 


Get a full list of upcoming 
events for February and 
beyond here: 


rpf.io/jam 


07. South Devon Tech Jam 

^ Saturday 8 February 

Q9 Paignton Library and Information Centre, Paignton, UK 
> magpi.cc/9vhGQ5 

A monthly informal and friendly session for anyone 
interested in technology, regardless of age or ability. 


08. Birthday Jams! 

© Saturday 29 February 

Q Earth, Sol System, Milky Way 

> rpf.io/jam 

Raspberry Pi turns eight this year! To celebrate, there will be 
Jams around the world for a month! See page 84 for more 
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8 e Want a Raspberry Jam 
5 6 in your area? Want to 
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s $ 
O We've highlighted some of the areas Raspberry Jam advice: D 
in need of a Jam! Can you help out? . ` 


á AN hen I ran my first Jam in 2012, you 
could only buy one Raspberry Pi at a 
time, and you had to wait about three 

months. The Jam was essentially the 30 people in 

Manchester who were lucky enough to buy one on day 

one! Following that, more people managed to get hold 

of a Raspberry Pi. It wasn't a problem that the Jam 
had no kit of its own: people were expected to 
bring their own. They were happy working on 

their own personal projects, and getting help re - € > 

from each other.” T TANW Y 


hA 3 
Ben Nuttall - Manchester Raspberry Jam Log 9° 
a 
— nn... e 2 
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Every Raspberry Jam is entitled to apply for a 
Jam starter kit, which includes magazine issues, X 
printed worksheets, stickers, flyers, and more. 
Get the book here: rpf.io/guidebook 
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. RETRO GAMING ` 
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RASPBERRY P 


Retro Gaming with Raspberry Pi shows you 
how to set up a Raspberry Pi to play classic games. 
Build your own portable console, full-size arcade 
cabinet, and pinball machine with our step-by-step 
guides. And learn how to program your own games, 
using Python and Pygame Zero. 


= Set up your Raspberry 
Pi for retro gaming 

m Emulate classic 
computers and consoles 

m Learn to program 
retro-style games 

m Build a portable 
console, arcade cabinet, 
and pinball machine 


BUY ONLINE: magpi.cc/store 
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Your @& 


Letters 


Donating issues 


Anyone want a load of 

The MagPi and HackSpace 
magazine issues? I need 

the room and I really don't 
want to just bin them. We 
don't have room for them at 
school either. 


Magri 


RETRO 


COMPUTING 


MAKE | BUILD | HACK | CREATE 


ackSpace 


Ha IN YOUR HANDS. 


Darren via Twitter 


Unfortunately, this is not 

an easy one to solve! We’ve 
retweeted your tweet, but 

uA z that’s about as much as we can 
= Sud d do - we do suggest that you 
look for any local Raspberry 
Jams, Code Clubs, CoderDojos, 
or makerspaces and getin 
contact with the organisers to 
see if they would like them. 
Otherwise, please recycle 
them responsibly! 


Contact us! 


@TheMagPi 


00000 
POWER, 


PYTHON SPARKS POLYSTYRENE NUTS & BOLTS 


A There are many places 
that would take copies 
of The MagPi and 
HackSpace magazine 


» Twitter 


» Facebook magpi.cc/facebook 


» Email 
» Online 


magpi@raspberrypi.org 
raspberrypi.org/forums 
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Great issue [Ed - in i 
reference to issue 

89, magpi.cc/89]: 

I particularly like 
Dale's Scratch tutorial 
on p44. Referring 

to your tips feature 

on p26 - one thing 

I find really handy 

is something that 
insulates. I was told to 
use clear nail varnish. 
Is this the best form 
of insulator or can 
you recommend 
something else? 


Ds ZINE 
YOUR OFFICIAL RASPBERRY PI Se 
| The F 


The official Raspberry pi magazine 


00 
January 2020 = 


Anne via email 


A Doyou have any extra 
i. ti 'd like to share? 
we’ve heard before, but apparently it is e 
completely real as a valid non-conductive 


insulator. It seems a few folks like to use flat 


Using clear nail varnish is not something 


colours like red and black for colour-coding if they need it 

as well. We reckon if you want to really do something fancy, 

check out UV varnish. 
As for other insulators, we like to heat up a glue gun and 

use the low setting to cover anything that might short. 

It’s especially effective for costume electronics, as it 

helps to keep wires attached if they’re moving more than 

they should. 


Coolest Projects 


registration 


I read a couple issues ago 

that registration for the 
American and UK versions of 
Coolest Projects was open, but 
registration for the International 
one wasn't yet. 1 assume it's 
because it’s a bit later in the 
year, but do you have any idea 
when we might learn news of 

its opening? 


Serg via Facebook 


You’re in luck - Coolest Projects 
International registration 
opened just before we went 
to print! It’s being held in 
Dublin on 6 June, and it’s 
available for everyone around 
the world. If you want to 
check out more about Coolest 
Projects, and register for the 
International event, head 
here: coolestprojects.org/ 
international. 


W We love to see some of the amazing 
projects that come out of Coolest 
Projects events! 
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제 The official Raspberry Pi 4 
power supply is a great 
charger for USB-C devices 


Power supply upgrade 


I'm thinking of upgrading to a Raspberry Pi 4 this year and was 
wondering what accessories I'd also need to upgrade to use it 
properly. Dm currently using a Raspberry Pi 3B, and have all the 
standard kit for that. I know DU need a new case and a micro HDMI 
cable, but otherwise am I good to go? I know that sometimes a 
power supply upgrade is needed, will I need a new PSU? 


E 


Jon via email 


The power port of Raspberry Pi 4 is USB-C, while older Raspberry Pi 
models use micro USB 2.0, so you will need some kind of upgrade to 
your power solution. 

Now, you don't necessarily need to get a USB-C charger - you can 
get a micro USB to USB-C adapter if your current power supply is 
powerful enough. If it's about 3A or higher, you should be OK. 

Otherwise, if you've got a new Android phone over the last year or 
so, you may already have a USB-C PSU. These are generally powerful 
enough to run Raspberry Pi 4 with few issues. Of course, if you don't 
have a charger, you can grab the official power supply. 
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PROTODOCK 
ADD-O 


Sometimes you have 


just a few too many 
components, microSD 
cards, and other gizmos 
for your Raspberry Pi 
projects. The ProtoDock 
helps you organise them. 


Ei The ProtoDock keeps 

your desk tidy and all 

of your vital Raspberry 

Pi accessories in 

one place D Eds ed o 
breadboard, not included 


Head here to enter: magpi.cc/win | Learn more: magpi.cc/protodock 


Terms & Conditions 


Competition opens on 29 January 2020 and closes on 27 February 2020. Prize is offered to participants worldwide aged 13 or over, except employees of the Raspberry Pi Foundation, 
the prize supplier, their families, or friends. Winners will be notified by email no more than 30 days after the competition closes. By entering the competition, the winner consents to any 
publicity generated from the competition, in print and online. Participants agree to receive occasional newsletters from The MagPi magazine. We don't like spam: participants’ details 
will remain strictly confidential and won't be shared with third parties. Prizes are non-negotiable and no cash alternative will be offered. Winners will be contacted by email to arrange 
delivery. Any winners who have not responded 60 days after the initial email is sent will have their prize revoked. This promotion is in no way sponsored, endorsed or administered by, 
or associated with, Instagram or Facebook. 
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Do-it-yourself computing 


Why DIY is about more than saving a few pennies. By Lucy Hattersley 


s all my friends can testify: I 
love DIY. Give me a drill and 


A a wall to damage and Pm a 


happy gal. 
And my DIY cup runneth over, since 


I recently moved into a new house that 
our local plumber Naim cheerfully 
referred to as: *Oh my God Luce this 
place is a wreck, are you sure?” 

The estate agents didn't even say 
it had ‘character’. The brochure 
said, with a hopeful look, that our 
new home was “in need of cosmetic 


glass of the iPhone and the security 
screws of the Microsoft Surface. Oh 
no, we hold our computer in our hand 
and say out loud, *How do you work, 
then, little one?" 

Sometimes we also say, “Why 
aren't you working, you absolute 
rotter." [We don't swear in The MagPi, 
house rule - Ed.] 

Doing-it-myself, or rather undoing 
the work of others to redo it, has given 
me an appreciation of good work. Good 
Work can be taken apart, examined, 


m | want to live in a world that | understand. If 
something goes wrong, | know how to fix it Ø 


decoration" and presented a 
"fantastic opportunity to add value to 
a property". 

And add value I have! Day and 
night with drill, and hammer, and 
screwdriver. The cat hates me; 
carpets have come up, stairs have 
been pulled down, and with more 
thana little help from Naim, a new 
kitchen has magically appeared. 

And all this DIY has got me 
thinking about Raspberry Pi. 


How does it work? 

Raspberry Pi is - above all else - 
the do-it-yourself of computing 
platforms. Not for us the glue and 
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understood, and reassembled. 
Raspberry Pi is good work. 

And I think doing- it-yourself is 
important. Because the alternative 
is somebody-else-does- it-for-you. 
And that comes at a heavy cost (and 
I don't mean money). Somebody- 
else-does-it-for-you means they get 
to understand the world you live in. 
They get all the joy of a job well done; 
if something goes wrong, you need to 
call them and ask for help. 

I want to live in a world that I 
understand. If something goes wrong, 
I know how to fix it, how to stop it 
getting worse, and at least where to 
look to solve the problem. 


Do-it-yourself computing is 
important. In a world of locked- 
down devices and black-box artificial 
intelligence, do-it-yourself computing 
is a shield against superficiality. It 
helps you to take the modern world 
apart and get a grip on how it ticks. 

It's also good for the environment. 
Learn to make something and you can 
fix and repair it, improve it, and gain 
an appreciation for the immediate 
world around you. 


Sustainable devices 

Repair is the new green, as iFixit says 
(magpi.cc/ifixitrepair): “Sustainable 
devices are devices that are designed 
to have a long life - and that means 
prioritising repair and upgradability. 
Devices that are easier to disassemble 
are also easier to recycle. Reusing, 
repairing, and recycling are always 
greener than manufacturing 
something anew.” 

DIY - both in your computing and 
in your home - is good for the soul 
and good for the world. Long may 
it continue. M 


Lucy Hattersley 


Lucy is the editor of The MagPi and is 
doing it all just to get more space for a 
dog. A dog with a lot to live up to. 
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Perfect option for your DIY or high-volume commercial projects 


Fits all kinds of HATs 
Ideal PoE HAT case 


Use with HAT or Pi alone 
Simple and professional 


Rapid, tool-free assembly 
GPIO cable pass-through 


Two wall mount options 
Well ventilated 


Designed and manufactured in North America 


INSPIRE FUTURE GENERATIONS 
o WITH PIPER COMPUTER KIT 2 


the award-winning computer kit forages 8+ 


